TinyFishFetchTool

def __init__(
    self,
    *,
    llm_config: LLMConfig | dict[str, Any] | None = None,
    tinyfish_api_key: str | None = None,
):
    """Initializes the TinyFishFetchTool.

    Args:
        llm_config (Optional[Union[LLMConfig, dict[str, Any]]]): LLM configuration.
            (Currently unused but kept for potential future integration).
        tinyfish_api_key (Optional[str]): The API key for the TinyFish API. If not provided,
            it attempts to read from the ``TINYFISH_API_KEY`` environment variable.

    Raises:
        ValueError: If ``tinyfish_api_key`` is not provided either directly or via the environment variable.
    """
    self.tinyfish_api_key = tinyfish_api_key or os.getenv("TINYFISH_API_KEY")

    if self.tinyfish_api_key is None:
        raise ValueError("tinyfish_api_key must be provided either as an argument or via TINYFISH_API_KEY env var")

    def tinyfish_fetch(
        urls: Annotated[list[str], "URLs to fetch and extract. TinyFish supports 1-10 URLs."],
        tinyfish_api_key: Annotated[str | None, Depends(on(self.tinyfish_api_key))],
        format: Annotated[str | None, "Output format: 'markdown', 'html', or 'json'."] = None,
        links: Annotated[bool | None, "Whether to include page links in results."] = None,
        image_links: Annotated[bool | None, "Whether to include image links in results."] = None,
    ) -> dict[str, Any]:
        """Fetch and extract content from URLs using TinyFish Fetch.

        Args:
            urls: URLs to fetch and extract.
            tinyfish_api_key: The API key for TinyFish (injected dependency).
            format: Output format: "markdown", "html", or "json".
            links: Whether to include page links in results.
            image_links: Whether to include image links in results.

        Returns:
            A dictionary containing successful fetch results and per-URL errors.

        Raises:
            ValueError: If the TinyFish API key is not available.
        """
        if tinyfish_api_key is None:
            raise ValueError("TinyFish API key is missing.")
        return _tinyfish_fetch(
            urls=urls,
            tinyfish_api_key=tinyfish_api_key,
            format=format,
            links=links,
            image_links=image_links,
        )

    super().__init__(
        name="tinyfish_fetch",
        description="Fetch and extract clean content from URLs using TinyFish. Returns extracted content and per-URL errors.",
        func_or_tool=tinyfish_fetch,
    )