langchain-youdotcom 0.1.0

An integration package connecting You.com and LangChain

langchain-youdotcom

LangChain partner package for You.com search and content APIs.

Installation

pip install -U langchain-youdotcom

Credentials

Get an API key at you.com/platform/api-keys, then set it as an environment variable:

export YDC_API_KEY="your-api-key"

Or pass it directly when instantiating any component:

retriever = YouRetriever(ydc_api_key="your-api-key")

Retriever

The simplest way to get You.com search results as LangChain documents.

from langchain_youdotcom import YouRetriever

retriever = YouRetriever()
docs = retriever.invoke("latest AI news")

for doc in docs:
    print(doc.metadata["title"])
    print(doc.page_content[:200])
    print()

All search parameters are available directly on the retriever:

retriever = YouRetriever(
    k=5,                    # max documents to return
    count=10,               # max results per API section
    livecrawl="web",        # fetch live page content
    livecrawl_formats="markdown",
    country="US",
    freshness="week",       # day, week, month, year
    safesearch="moderate",  # off, moderate, strict
)

Tools

YouSearchTool

Search the web with You.com. Works with any LangChain agent.

from langchain_youdotcom import YouSearchTool

tool = YouSearchTool()
result = tool.invoke("what is retrieval augmented generation")
print(result)

YouContentsTool

Fetch and extract content from web pages.

from langchain_youdotcom import YouContentsTool

tool = YouContentsTool()
result = tool.invoke({"urls": ["https://example.com"]})
print(result)

Using with an agent

from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

from langchain_youdotcom import YouSearchTool

tools = [YouSearchTool()]
agent = create_react_agent(ChatOpenAI(model="gpt-4o"), tools)

response = agent.invoke(
    {"messages": [{"role": "user", "content": "what happened in AI today?"}]}
)

YouSearchAPIWrapper

For more control, use the wrapper directly. It powers the retriever and tools under the hood.

from langchain_youdotcom import YouSearchAPIWrapper

wrapper = YouSearchAPIWrapper()

# search -> list[Document]
docs = wrapper.results("latest AI news")

# raw SDK response
raw = wrapper.raw_results("latest AI news")

# contents API -> list[Document]
pages = wrapper.contents(
    ["https://example.com"],
    formats=["markdown", "metadata"],
)

Async variants are available as results_async, raw_results_async, and contents_async.

Documentation

• You.com API docs
• You.com API keys

Development

uv sync --all-groups
make format            # ruff format + fix
make lint              # ruff check + format diff + mypy
make test              # unit tests
make integration_tests # requires YDC_API_KEY
make check_imports     # verify all modules importable