langchain-clawfetch

LangChain tools for ClawFetch, a pay-per-call web intelligence API for AI agents. Each call is paid with an x402 micropayment in USDC on Base.

Install

pip install langchain-clawfetch

Wallet

You need a Base wallet private key that holds USDC. There is no API key and no signup. Payments are gasless EIP-3009 transfers signed locally by the clawfetch SDK, so the wallet does not need ETH. Use a dedicated wallet with a small balance.

export CLAWFETCH_PRIVATE_KEY=0x...

Quickstart

from langchain_clawfetch import ClawFetchToolkit

tools = ClawFetchToolkit().get_tools()  # reads CLAWFETCH_PRIVATE_KEY
# or: ClawFetchToolkit(private_key="0x...", max_chars=8000)

fetch = tools[0]
print(fetch.invoke({"url": "https://example.com"}))

To use the tools with an agent:

from langchain.agents import create_agent

agent = create_agent(llm, tools=tools)  # llm: any LangChain chat model
agent.invoke({"messages": [{"role": "user", "content": "What's new on news.ycombinator.com?"}]})

You can also create a single tool, or pass an existing client:

from clawfetch import ClawFetch, AsyncClawFetch
from langchain_clawfetch import ClawFetchResearch

research = ClawFetchResearch(client=ClawFetch(private_key="0x..."), async_client=AsyncClawFetch(private_key="0x..."))

Every tool supports invoke and ainvoke. Async calls use AsyncClawFetch.

Tools

Supported clawfetch_extract sites: twitter, coingecko, github, news, npm, pypi, crates, hackernews, youtube, wikipedia, producthunt, imdb, amazon, crunchbase, sec-edgar, zillow, redfin.

Output and errors

Tools return a string. Fetch and render return the page title, URL and text. Parse returns Markdown. The other tools return the API response as JSON. Output is cut at max_chars (default 10,000).

SDK errors (PaymentError, RateLimitError, ApiError, NetworkError) are raised as ToolException. To hand the message to the model instead of raising, pass handle_tool_error=True when you create a tool.

License

MIT