A collection of open-source recipes and sample applications built with the TinyFish web agents API, the TinyFish Cookbook targets developers aiming to automate website interactions. It solves the complexity of managing headless browsers, selectors, and proxies by transforming websites into programmable surfaces. The primary benefit is enabling users to focus on product logic by abstracting intricate web automation plumbing.

How It Works

TinyFish functions as a web agents API, accepting a URL and a natural language goal to return structured JSON. It handles complex web interactions like form filling, dynamic content, and multi-step flows across multiple sites. The system employs real browser automation within stealth browser profiles, incorporating rotating proxies to mitigate anti-bot defenses, all supported by production-grade logging for observability.

Quick Start & Requirements

Setup requires obtaining an API key from tinyfish.ai. Interaction is primarily via standard HTTP requests, with examples provided for cURL, Python, and TypeScript. No heavy SDKs are necessary. The service also offers tinyfi.sh for local demo exposure.

Highlighted Details

• Treats any website as a programmable API, even those without official APIs.
• Converts natural language goals into structured JSON outputs.
• Automates real browser interactions, including complex multi-step flows.
• Features built-in stealth capabilities with rotating proxies to bypass bot defenses.
• Provides production-grade logs for monitoring and debugging.
• Offers flexible integration options: direct HTTP API, visual Playground, or MCP server.
• Includes a growing library of diverse recipes, such as anime-watch-hub, bestbet, and competitor-analysis.

Maintenance & Community

The project encourages community contributions for new recipes and offers support via a Discord server. Further information and API access are available at tinyfish.ai.

Licensing & Compatibility

A link to a "License" page is provided, but the specific license type and its implications for commercial use or closed-source linking are not detailed within this README.

Limitations & Caveats

This README focuses on showcasing the capabilities and examples of the TinyFish API. Explicit limitations, unsupported platforms, or known bugs of the core TinyFish service are not detailed here.