agent

TinyFish Agent

Browser automation via the bundled TinyFish MCP server. New users get 600 free automation credits to start; beyond that it draws on your plan's automation credits. Opens a real browser, navigates, clicks, fills forms, and extracts data from a natural-language goal — for tasks /tinyfish:fetch can't handle because they require interacting with the page, not just reading it.

run_web_automation

• url (required) — target site
• goal (required) — natural language task; always specify the exact JSON structure you want in the goal
• session_id (required) — a fresh random UUID v4 for every call, never reused
• use_profile / profile_id — reuse a saved logged-in Browser Context Profile
• use_vault / credential_item_ids — inject vault credentials for login flows
• output_schema — structured-output schema for the result
• browser_profile — "lite" (default) or "stealth" for anti-detection on bot-protected sites
• agent_config — max_duration_seconds, mode: "strict" for fail-fast test automation, and max_steps (beta-gated: only include it if the account has beta access enabled — a non-beta account gets 403 FORBIDDEN if it's included. Omit it to use the default of 150.)

run_web_automation(
  url="https://example.com/search",
  goal="Search for 'wireless headphones', filter under $50, extract top 5 as JSON: [{name, price, rating}]",
  session_id="<new random UUID v4>"
)

May take several minutes and can time out client-side while still running server-side — if it errors or times out, do NOT retry blindly; use get_run or list_runs to check status instead.

Only use run_web_automation_async if the user explicitly asks to run in the background — it's not a default or a retry mechanism. Poll with get_run every 30-60s.

Multiple independent sites — use batch_create, not repeated calls.

batch_create / batch_status / batch_cancel

For the same task across 2+ URLs:

batch_create(runs=[
  {url: "https://pizzahut.com", goal: "Extract pizza prices as JSON: [{name, price}]"},
  {url: "https://dominos.com", goal: "Extract pizza prices as JSON: [{name, price}]"}
])