pi-tinyfish-tools

TinyFish Web Agent tools for pi — search, fetch, and goal-driven browser automation

Packages

Package details

extensionskill

Install pi-tinyfish-tools from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-tinyfish-tools
Package
pi-tinyfish-tools
Version
0.1.3
Published
May 24, 2026
Downloads
not available
Author
diwu507
License
MIT
Types
extension, skill
Size
46.6 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-tinyfish

TinyFish Web Agent tools for pi — search, fetch, and goal-driven browser automation.

Tools

Tool API Description
tinyfish_search Search API Web search with ranked results, snippets, and URLs
tinyfish_fetch Fetch API Render URLs and extract clean content (markdown/html/json)
tinyfish_agent_run Agent API (SSE) Goal-driven browser automation with real-time progress
tinyfish_run_get Runs API Query a specific automation run's status and result
tinyfish_run_list Runs API List/search historical automation runs
tinyfish_run_cancel Runs API Cancel an in-progress run

Setup

  1. Install:
pi install npm:pi-tinyfish
# or local:
pi install ./pi-tinyfish
  1. Configure your TinyFish API key (get one from agent.tinyfish.ai/api-keys):
/tinyfish-login
  1. Check status:
/tinyfish-status

Configuration

API key and defaults are stored in ~/.pi/agent/pi-tinyfish.json (permissions 0600). No global environment variable required.

{
  "apiKey": "tf_xxx",
  "defaultLocation": "US",
  "defaultLanguage": "en",
  "defaultFetchFormat": "markdown",
  "defaultBrowserProfile": "lite"
}

Fallback: TINYFISH_API_KEY env var for CI / debugging.

Commands

Command Description
/tinyfish-login Enter your TinyFish API key interactively
/tinyfish-status Show configuration status (key never exposed)
/tinyfish-logout Remove stored API key

Development

npm install          # peer deps
npm test             # vitest
pi -e .             # load extension for testing

Design

See ISSUE-1.md for the complete design document.