tinyfish-integration

TinyFish Integration

TinyFish is a web toolkit for AI agents that provides search, fetch, and browser automation capabilities. Search and fetch are free for every account — no credits, no cost.

Available Tools

tinyfish_search

Search the live web and get structured, agent-ready results.

Use cases:

• Current information, news, prices
• Finding URLs before fetching content
• Anything that changes over time

Parameters:

• query (required): Search query string
• location (optional): 2-letter country code (e.g., "US", "FR", "ID")
• language (optional): 2-letter language code (e.g., "en", "fr", "id")
• page (optional): Page number for pagination (default: 0)

Example:

tinyfish_search(query="Hermes Agent AI", location="US", language="en")

Response format:

{
  "results": [
    {
      "title": "Page Title",
      "url": "https://example.com",
      "snippet": "Description text...",
      "site_name": "Example Site"
    }
  ]
}

tinyfish_fetch

Pull the full content of any web page as clean extracted text.

Use cases:

• Reading articles, docs, product pages
• Extracting content without ads/navigation
• Batch processing multiple URLs (max 10)

Parameters:

• urls (required): Single URL or comma-separated list (max 10)

Examples:

# Single URL
tinyfish_fetch(urls="https://example.com")

# Multiple URLs
tinyfish_fetch(urls="https://site1.com, https://site2.com, https://site3.com")

Response format:

{
  "results": [
    {
      "url": "https://example.com",
      "final_url": "https://example.com",
      "title": "Page Title",
      "description": "Meta description",
      "language": "en",
      "text": "# Heading\n\nClean extracted content..."
    }
  ],
  "errors": []
}

Setup

1. Get API Key

Visit https://agent.tinyfish.ai/api-keys to get your API key.

2. Configure Hermes

Add to ~/.hermes/.env:

TINYFISH_API_KEY=sk-tinyfish-YOUR_KEY_HERE