Search1API

Servidor MCP Search1API

Documentação em chinês

O servidor MCP oficial para Search1API — busca na web, notícias, recuperação de páginas, descoberta de sitemaps e tópicos em alta em uma única API.

Autenticação

• Clientes com suporte a OAuth podem se conectar diretamente à URL MCP remota e, em seguida, fazer login e aprovar o acesso no navegador.
• Integrações existentes podem continuar usando uma chave de API do painel do Search1API.
• Toda solicitação MCP — incluindo descoberta de ferramentas (initialize, tools/list) — exige uma credencial. Solicitações não autenticadas acionam o desafio OAuth, que é como os clientes iniciam o login; a inspeção pré-conexão é fornecida pelo cartão de servidor estático.

Início Rápido (MCP Remoto)

Nenhuma instalação necessária. Configure seu cliente MCP com a URL remota. Use OAuth quando o cliente suportar, ou forneça uma chave de API.

Autenticação

Três métodos são suportados — use o que seu cliente suportar:

Método	Formato
OAuth 2.1	Conecte-se a https://mcp.search1api.com/mcp sem chave e siga o fluxo de login do cliente
Cabeçalho de Autorização	Authorization: Bearer YOUR_SEARCH1API_KEY
Parâmetro de Consulta na URL (legado)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Prefira OAuth ou o cabeçalho de Autorização. Credenciais em parâmetros de consulta podem ser expostas em URLs, logs e histórico do shell.

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (Web)

Configurações > Conectores > Adicionar conector personalizado:

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

Instale como um plugin do Cursor (recomendado): este repositório inclui Agent Plugins plugin.json + mcp.json (portátil) e .cursor-plugin/plugin.json (metadados / logotipo do Cursor Marketplace) para MCP Remoto com OAuth. Envie ou instale a partir de cursor.directory / Cursor Marketplace e faça login quando solicitado.

Para testes locais, copie os arquivos do plugin para ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Não use symlink de fora desse diretório — o Cursor rejeita alvos de symlink externos.

Ou configure manualmente:

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

Habilidade do Agente

A Habilidade do Agente foi movida para search1api-cli. Instale-a com:

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

Modo Local (stdio)

Se preferir executar o servidor localmente, use Node.js 20 ou mais recente com npx — sem necessidade de clonar:

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Para implantações HTTP auto-hospedadas atrás de um proxy, adicione quaisquer nomes de host internos que alcancem o processo Node.js à variável de ambiente MCP_ALLOWED_HOSTS separada por vírgulas. mcp.search1api.com e endereços localhost são permitidos por padrão. Clientes baseados em navegador que enviam um cabeçalho Origin também devem ter seus nomes de host de origem confiáveis adicionados à variável MCP_ALLOWED_ORIGINS separada por vírgulas. Solicitações de clientes MCP do lado do servidor normalmente omitem Origin e não exigem uma entrada.

Ferramentas

search

Pesquise na web usando Search1API. Os resultados incluem uma estrutura citável id/title/url. Passe uma URL de resultado para crawl quando precisar da página completa.

Parâmetro	Obrigatório	Padrão	Descrição
query	Sim	-	Consulta de pesquisa
max_results	Não	10	Número de resultados
search_service	Não	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	Não	0	Número de principais resultados a rastrear para conteúdo completo; cada rastreamento bem-sucedido adiciona 1 crédito à solicitação de pesquisa base de 1 crédito
include_sites	Não	[]	Sites a incluir
exclude_sites	Não	[]	Sites a excluir
time_range	Não	-	dia, mês, ano

news

Pesquise artigos de notícias.

Parâmetro	Obrigatório	Padrão	Descrição
query	Sim	-	Consulta de pesquisa
max_results	Não	10	Número de resultados
search_service	Não	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	Não	0	Número de principais resultados a rastrear para conteúdo completo; cada rastreamento bem-sucedido adiciona 1 crédito à solicitação de notícias base de 1 crédito
include_sites	Não	[]	Sites a incluir
exclude_sites	Não	[]	Sites a excluir
time_range	Não	-	dia, mês, ano

crawl

Extraia conteúdo de uma URL.

Parâmetro	Obrigatório	Descrição
url	Sim	URL a rastrear

sitemap

Obtenha todos os links relacionados de uma URL.

Parâmetro	Obrigatório	Descrição
url	Sim	URL para obter o sitemap

trending

Obtenha tópicos em alta de plataformas populares.

Parâmetro	Obrigatório	Padrão	Descrição
search_service	Sim	-	github, hackernews
max_results	Não	10	Número de itens

Histórico de Versões

• v0.6.1: Correção de bug — a descoberta MCP (initialize, tools/list, resources/*, prompts/list, server/discover) exige credencial novamente. Servi-la anonimamente fazia com que clientes que equiparam "ferramentas listadas" a "conectado" mostrassem um estado conectado sem forma de acionar o fluxo OAuth; o desafio 401 agora responde a toda solicitação não autenticada, restaurando o login OAuth no momento da conexão. A visibilidade no diretório permanece inalterada via cartão de servidor estático e metadados de registro
• v0.6.0: A descoberta MCP (initialize, tools/list, resources/*, prompts/list, server/discover) é servida sem credencial para que clientes e diretórios possam enumerar ferramentas antes de fazer login; chamadas de ferramentas ainda exigem OAuth ou chave de API. O modo stdio inicia sem SEARCH1API_KEY e serve metadados de ferramentas, recusando apenas no momento da chamada. Solicitações malformadas respondem como JSON-RPC em vez de uma página de erro HTML
• v0.5.4: Emissor OAuth movido para clerk.s1.dev e configurável com OAUTH_AUTHORIZATION_SERVER; cartão de servidor MCP publicado em /.well-known/mcp/server-card.json; documentos de descoberta OAuth agora enviam cabeçalhos de cache
• v0.5.3: Metadados de recurso e ferramenta OAuth não exigem mais escopos de sessão OIDC; selos de registro Smithery e Glama adicionados
• v0.5.2: A validação MCP Origin agora é executada antes do parsing de solicitação e autenticação; implantações HTTP auto-hospedadas podem configurar origens de navegador confiáveis com MCP_ALLOWED_ORIGINS
• v0.5.1: Documentação, manifesto LobeHub e metadados do MCP Registry sincronizados; robots.txt servido no host de transporte
• v0.5.0: Suporte MCP 2026-07-28 com negociação automática de protocolo; compatibilidade sem estado para clientes HTTP da era 2025; autenticação em nível de solicitação
• v0.4.0: Esquemas de saída estruturados, esquemas de segurança OAuth, anotações de segurança e metadados do Official MCP Registry
• v0.3.1: Suporte OAuth 2.1 para MCP Remoto; ferramenta de raciocínio aposentada removida
• v0.3.0: Suporte MCP Remoto via Streamable HTTP; autenticação por chave de API por sessão
• v0.2.0: Suporte de fallback .env para integração LibreChat
• v0.1.8: Serviços de busca X (Twitter) e Reddit
• v0.1.7: Ferramenta de tópicos em alta para GitHub e Hacker News
• v0.1.6: Serviço de busca Wikipedia
• v0.1.5: Novos parâmetros e serviços de busca (arxiv, wechat, bilibili, imdb)
• v0.1.3: Busca de notícias
• v0.1.2: Sitemap
• v0.1.1: Rastreamento web
• v0.1.0: Lançamento inicial

Licença

MIT