Search1API

Search1API MCP Server

中文文档

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.

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/logo do Cursor Marketplace) para MCP Remoto com OAuth. Envie ou instale a partir de cursor.directory / do 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 symlinks 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 — não é necessário 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. Endereços mcp.search1api.com e 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. Requisiçõ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 a URL de um 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 à requisiçã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	-	day, month, year

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 à requisiçã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	-	day, month, year

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.5.3: Metadados de recursos e ferramentas OAuth não exigem mais escopos de sessão OIDC; badges de registro Smithery e Glama adicionados
• v0.5.2: A validação Origin do MCP agora é executada antes do parsing de requisições e da 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 a 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 requisiçã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 a OAuth 2.1 para MCP Remoto; ferramenta de raciocínio aposentada removida
• v0.3.0: Suporte a MCP Remoto via Streamable HTTP; autenticação por chave de API por sessão
• v0.2.0: Suporte a fallback .env para integração com 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