Metadata-Version: 2.5
Name: langchain-x402serps
Version: 1.0.0
Summary: LangChain tools for x402serps, a third-party search provider (web search, news, places, extract). Pay with x402 USDC or a prepaid credit key.
Project-URL: Homepage, https://x402serps.com/integrations?utm_campaign=100sales
Project-URL: Documentation, https://x402serps.com/docs/langchain
Project-URL: Help, https://x402serps.com/help
Author-email: x402serps <hello@x402serps.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.9
Requires-Dist: langchain-core>=0.2
Requires-Dist: x402serps>=1.0.0
Description-Content-Type: text/markdown

# langchain-x402serps

LangChain tools for [x402serps](https://x402serps.com/integrations?utm_campaign=100sales), a third-party search provider.

Search is $0.004 per 10 results. Extract is $0.003 per URL. A 25-call trial is available; MCP includes 20 free calls per day.

## Install

```bash
pip install langchain-x402serps
```

## Quickstart

```python
from langchain_x402serps import x402serps_tools

tools = x402serps_tools(trial=True)
# or: x402serps_tools(api_key="xs_...")
# or: x402serps_tools(client=X402Serps(api_key="xs_..."))
```

Tools: `x402serps_search`, `x402serps_news`, `x402serps_places`, `x402serps_extract`.

```python
from langchain_openai import ChatOpenAI
from langchain_x402serps import x402serps_tools

llm = ChatOpenAI(model="gpt-4o-mini").bind_tools(x402serps_tools(trial=True))
msg = llm.invoke("Find recent coverage of the x402 payment protocol")
print(msg)
```

For x402 USDC payments, build a paying client as shown in the [x402serps README](https://pypi.org/project/x402serps/) and pass it as `client=` (synchronous paying sessions; the async httpx wrapper is covered in the core package).

Help: https://x402serps.com/help
