Skip to main content

TinyFish

Automate browser workflows with natural-language goals, search the web, and fetch page content via TinyFish's Agent, Search, Fetch, and Browser APIs.

Categories: Automation, Web Scraping

What you can ask​

  • Run a browser automation that finds the cheapest plan on a vendor's pricing page
  • Start a batch of automations that check order status across supplier portals
  • Fetch a list of URLs and return their content for summarization

Set up​

TinyFish connects with credentials from your TinyFish account. Have these values ready:

  • API key
  1. Go to Organization > Connectors and find TinyFish.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

TinyFish offers 21 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (14)​

View and search information without changing it.

ToolWhat it does
fetch_urlsFetch and extract content from 1-10 URLs.
get_runGet full detail for one run, including its steps.
get_run_step_htmlGet the raw HTML snapshot for one run step.
get_run_step_screenshotGet the screenshot for one run step as base64-encoded JPEG.
get_runs_batchGet full detail for up to 100 runs by ID in a single call.
get_walletGet the current wallet balance, auto-reload configuration, and billing rates for this account.
list_browser_profilesList saved Browser Context Profiles (persistent logged-in browser state).
list_browser_session_usageList paginated usage records for browser sessions, optionally filtered by session_id or status.
list_fetch_usageList paginated usage records for the fetch API.
list_runsList automation runs with optional server-side filters (status, goal substring, date range) and sorting.
list_search_usageList paginated usage records for the search API.
list_vault_credentialsList vault credential items available to this account.
search_webRun a web search and return ranked results.
validate_credentialCheck that the TinyFish connection works by calling the wallet endpoint.

Write (1)​

Create or send data.

ToolWhat it does
create_browser_sessionCreate a remote browser session and return its Chrome DevTools Protocol (CDP) endpoint.

Delete or overwrite (6)​

Remove or replace existing data.

ToolWhat it does
cancel_runCancel a pending or running automation run.
cancel_runs_batchCancel up to 100 pending or running automation runs by ID in a single call.
close_browser_sessionClose a remote browser session created by create_browser_session, ending its per-minute billing immediately.
run_automationRun a browser automation synchronously and wait for the result (up to agent_config.max_duration_seconds, default several minutes).
start_automationQueue a browser automation run and return immediately with a run_id, without waiting for it to finish.
start_automations_batchQueue 1-100 browser automation runs atomically and return their run_ids immediately.
⌘J