Real-time web search, URL content extraction, and cited multi-source research from You.com's production search index. Free keyless tier available.You.com

https://github.com/youdotcom-oss/dx-toolkitPesquisa web em tempo real, extração de conteúdo de URLs e pesquisa multi-fonte com citações do índice de busca de produção da You.com. Camada gratuita sem chave disponível.

GitHub
24

Documentação

@youdotcom-oss/mcp

Ponte STDIO somente-binário para o servidor MCP hospedado da You.com em https://api.you.com/mcp.

Este pacote não registra ferramentas localmente e não contém lógica de ferramentas REST. Sua única função é fazer proxy do tráfego MCP STDIO para o servidor remoto hospedado.

Início rápido

// Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.)
// Free tier — no API key, no signup.
{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Se o seu cliente suporta MCP remoto, aponte-o diretamente para https://api.you.com/mcp?profile=free — nenhum processo local é necessário.

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Autenticado (todas as ferramentas padrão):

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_API_KEY": "<your-key>" }
    }
  }
}

Claude Code

# Free tier
claude mcp add you -e YDC_PROFILE=free -- npx @youdotcom-oss/mcp

# Authenticated
claude mcp add you -e YDC_API_KEY=<your-key> -- npx @youdotcom-oss/mcp

Cursor

Adicione a ~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto):

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

VS Code

Adicione ao seu mcp.json de usuário ou espaço de trabalho:

{
  "servers": {
    "you": {
      "command": "npx",
      "args": ["@youdotcom-oss/mcp"],
      "env": { "YDC_PROFILE": "free" }
    }
  }
}

Qualquer cliente MCP (remoto)

Se o seu cliente suporta HTTP streamable, pule a ponte local:

https://api.you.com/mcp?profile=free

Autenticado:

https://api.you.com/mcp
Authorization: Bearer <your-key>

Instalação

bun add @youdotcom-oss/mcp

Ou execute diretamente:

npx @youdotcom-oss/mcp

Ambiente

  • YDC_API_KEY Opcional. Enviado como Authorization: Bearer <key>.
  • YDC_PROFILE Opcional. Quando definido como free, roteia a ponte para https://api.you.com/mcp?profile=free.
  • YDC_ALLOWED_TOOLS Opcional. IDs de ferramentas hospedadas separados por vírgula para expor através de https://api.you.com/mcp?tools=....

YDC_PROFILE tem precedência sobre YDC_ALLOWED_TOOLS.

Exposição de ferramentas

A URL MCP hospedada padrão expõe quatro ferramentas:

  • you-search
  • you-contents
  • you-balance
  • you-discover

Duas ferramentas adicionais estão disponíveis mediante solicitação:

  • you-finance
  • you-research

Solicite ferramentas adicionais explicitamente com tools. tools define o escopo do conjunto de ferramentas visível.

Hoje, profile=free é um modo sem chave. Ele substitui tools e expõe you-search e you-discover.

Exemplos:

  • Conjunto de ferramentas padrão: https://api.you.com/mcp
  • Somente finanças: https://api.you.com/mcp?tools=you-finance
  • Busca mais finanças: https://api.you.com/mcp?tools=you-search,you-finance
  • Somente pesquisa: https://api.you.com/mcp?tools=you-research
  • Perfil gratuito (sem chave): https://api.you.com/mcp?profile=free

Links

Contribuindo

A configuração de desenvolvimento e as convenções de código estão em AGENTS.md; o fluxo de contribuição e as convenções de PR estão em CONTRIBUTING.md. Problemas e PRs são bem-vindos.

Licença

MIT — veja LICENSE.