Skip to main content
you-contents extracts full page content from URLs via You.com’s remote MCP server. It supports markdown, HTML, and metadata formats and handles multiple URLs in a single request.
you-contents cannot be used via the DSL path (mcps=[]). crewAI’s _json_type_to_python maps all "array" types to bare list, which Pydantic v2 generates as {"items": {}} — a schema that OpenAI rejects. You must use MCPServerAdapter with the schema patching helpers below.
you-contents is not available on the free tier (?profile=free). An API key is required.

Installation

Environment Variables

  • YDC_API_KEY (required)
Get an API key at https://you.com/platform/api-keys.

Parameters

ParameterRequiredTypeDescription
urlsYesarray[string]URLs to extract content from (e.g., ["https://example.com"])
formatsNoarray[string]Output formats: "markdown", "html", "metadata"
crawl_timeoutNointegerTimeout in seconds (1–60) for page crawling

Format Guidance

FormatBest for
markdownText extraction, readability, LLM consumption
htmlLayout preservation, interactive content, visual fidelity
metadataStructured page information (site name, favicon, OpenGraph data)

Example

Schema patching is required — mcpadapt generates invalid JSON Schema fields (anyOf: [], enum: null) that OpenAI rejects. The helpers below clean these schemas:
Code
A common pattern: search with you-search via DSL, then extract content with you-contents via MCPServerAdapter. See You.com Search & Research Tools for search configuration.
Code

Security

you-contents is higher risk for indirect prompt injection than search tools — it returns full page HTML/Markdown from arbitrary URLs. Always include the trust boundary in the agent’s backstory and never pass user-supplied URLs directly without validation. See MCP Security for full details.