AnySearch

Habilidade unificada de busca em tempo real para agentes de IA.

Documentação

Servidor MCP AnySearch

English | 简体中文

Servidor MCP de busca unificada em tempo real com suporte a busca web geral, busca por domínio vertical, busca em lote paralela e extração de conteúdo completo de URLs.

Recursos

Busca Web Geral — consultas em linguagem natural abertas
Busca por Domínio Vertical — consultas estruturadas em finanças, acadêmico, segurança, jurídico, código e mais
Busca em Lote Paralela — execute múltiplas consultas independentes em uma única chamada
Extração de Conteúdo de URL — busca e extrai o conteúdo completo da página como Markdown
Acesso Anônimo — funciona sem chave de API (com limites de taxa menores)

Configuração da Chave de API

Uma chave de API é opcional, mas recomendada. Sem uma chave, todos os recursos ainda funcionam via acesso anônimo com limites de taxa menores.

Registrar para uma Chave de API (Recomendado)

O agente pode registrar o usuário e obter uma chave de API em uma única chamada — sem código de verificação, sem cadastro manual. Peça ao usuário um endereço de e-mail real: ele se torna o nome de usuário da conta.

curl -s -X POST "https://api.anysearch.com/v1/auth/email/register" \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

Resposta de sucesso (code: 0) retorna as informações da conta e uma chave de API em texto simples de uso único:

{
  "code": 0,
  "message": "success",
  "data": {
    "username": "you@example.com",
    "email": "you@example.com",
    "login_url": "https://www.anysearch.com/login",
    "api_key": {
      "id": "key_xxxxxxxx",
      "key": "as_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "key_prefix": "as_sk_xxxxxx...",
      "name": "default",
      "rate_limit": 100,
      "quota_limit": 0,
      "expires_at": null,
      "created_at": "2026-06-23T10:23:00Z"
    }
  }
}

Campos de cota como rate_limit são valores de resposta específicos da conta; não trate o exemplo como um plano fixo.

Em caso de sucesso, o agente DEVE:

Colocar data.api_key.key na configuração do servidor MCP como o valor de Authorization: Bearer <key> (e/ou definir ANYSEARCH_API_KEY) — ele é mostrado apenas uma vez (também pode ser recuperado posteriormente no painel).
Informar ao usuário seu nome de usuário (= e-mail) e o login_url.

Erros podem ser expressos por meio do status HTTP, code em nível de aplicação, ou message; não presuma que todo erro usa code: -1:

status / código / mensagem	o que fazer
`Invalid email address.`	peça ao usuário para reinserir o e-mail
HTTP `409` ou `email_already_registered`	e-mail já está em uso — informe ao usuário para entrar em `login_url`; não tente novamente
`code: 42901`, `rate_limited`, ou contém `Rate limited`	prefira um atraso de nova tentativa de `Retry-After`, dados de resposta, ou a mensagem; se nenhum for fornecido, pare as solicitações repetidas e tente novamente mais tarde ou use acesso anônimo
começa com `Key creation failed.`	conta criada, mas a chave falhou — extraia o e-mail e a URL da mensagem (`"Key creation failed. Your account <email> was created; sign in at <url>."`) e informe ao usuário para entrar lá e criar uma chave manualmente
`Internal server error.`	tente novamente mais tarde ou use acesso anônimo

O e-mail deve ser real e acessível.

Obter uma Chave de API

Alternativamente, visite https://anysearch.com/console/api-keys para criar uma chave de API gratuita.

Prioridade da Chave

Prioridade	Fonte
1 (mais alta)	`--api_key` flag de CLI / `Authorization` cabeçalho
2	Variável de ambiente `ANYSEARCH_API_KEY`
3	Arquivo `.env` (`ANYSEARCH_API_KEY=<key>`)
4	Acesso anônimo (limites de taxa menores)

Comportamento da Chave

Cenário	Comportamento
Sem chave	Prosseguir com acesso anônimo (limites de taxa menores)
Com chave	Enviada via cabeçalho `Authorization: Bearer <key>`, limites de taxa maiores
Chave esgotada, chave registrada automaticamente retornada	O agente deve pedir confirmação ao usuário e, em seguida, persistir a nova chave
Chave esgotada, sem nova chave	Informar o usuário e sugerir configurar uma nova chave de API

Transporte MCP

O endpoint de produção é:

https://api.anysearch.com/mcp

Ele usa nativamente Streamable HTTP. As versões atuais de OpenCode, Claude Code, Cursor, VS Code, Cline, OpenAI Codex, Google Antigravity, DeepSeek Harness, Hermes Agent e OMP podem se conectar diretamente a ele; nenhum proxy SSE ou stdio é necessário. As configurações abaixo seguem a documentação oficial atual de cada cliente.

Instalação

A chave de API é opcional. Onde um cliente documenta armazenamento de variável de ambiente ou segredo para cabeçalhos personalizados, os exemplos usam a configuração autenticada recomendada. Onde não documenta, o exemplo permanece anônimo e explica como adicionar autenticação apenas na configuração privada do usuário. Para usar acesso anônimo em outros lugares, remova apenas a entrada Authorization e mantenha X-Anysearch-Client.

OpenCode

Documentação oficial: Servidores MCP e locais de configuração.

Use ~/.config/opencode/opencode.json para uma configuração global ou opencode.json na raiz do projeto. No Windows, o caminho global é %USERPROFILE%\.config\opencode\opencode.json.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "anysearch": {
      "type": "remote",
      "url": "https://api.anysearch.com/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

OpenCode usa {env:NAME} para substituição de variável de ambiente. "oauth": false evita um fluxo de descoberta OAuth desnecessário para este servidor autenticado por chave de API.

Após salvar, execute opencode mcp list e confirme que anysearch é exibido como connected.

Claude Code

Documentação oficial: Conecte o Claude Code a ferramentas via MCP.

Para uma instalação privada, em todo o usuário, execute:

claude mcp add --transport http anysearch https://api.anysearch.com/mcp --scope user --header 'Authorization: Bearer ${ANYSEARCH_API_KEY}' --header 'X-Anysearch-Client: mcp/1.0.0'

O escopo user armazena o servidor em ~/.claude.json e o disponibiliza em todos os projetos da máquina. Aspas simples preservam a referência da variável para que a chave em texto simples não seja gravada na configuração; defina ANYSEARCH_API_KEY antes de iniciar o Claude Code. Para acesso anônimo, omita a opção Authorization --header.

Para uma configuração de projeto compartilhável, crie .mcp.json na raiz do projeto:

{
  "mcpServers": {
    "anysearch": {
      "type": "http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

O Claude Code expande ${VAR} e ${VAR:-default} em .mcp.json, inclusive dentro de url e headers. Defina ANYSEARCH_API_KEY antes de iniciar o Claude Code. Servidores com escopo de projeto exigem aprovação quando abertos interativamente pela primeira vez.

Verifique a conexão com:

claude mcp get anysearch
claude mcp list

Dentro do Claude Code, /mcp mostra o status do servidor e as ferramentas disponíveis.

Cursor

Documentação oficial: Model Context Protocol.

Use .cursor/mcp.json para um projeto ou ~/.cursor/mcp.json globalmente:

{
  "mcpServers": {
    "anysearch": {
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

O Cursor reconhece automaticamente o endpoint HTTP remoto e suporta interpolação ${env:NAME} em url e headers.

Verifique a conexão em Customize > MCPs ou Output > MCP Logs. Se o CLI do Cursor estiver instalado, você também pode executar:

agent mcp list
agent mcp list-tools anysearch

VS Code

Documentação oficial: Adicionar e gerenciar servidores MCP e referência de configuração MCP.

Execute MCP: Open User Configuration para um servidor em todo o usuário, ou crie .vscode/mcp.json em um workspace. Este exemplo usa uma entrada de senha para que a chave seja solicitada e armazenada com segurança em vez de ser commitada:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "anysearch-api-key",
      "description": "AnySearch API key",
      "password": true
    }
  ],
  "servers": {
    "anysearch": {
      "type": "http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:anysearch-api-key}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

Para acesso anônimo, remova a entrada Authorization e todo o array inputs.

Execute MCP: List Servers, selecione anysearch e escolha Start ou Show Output para verificar a conexão. Observe que ${input:...} funciona no VS Code local, mas servidores que exigem entrada interativa não são encaminhados ao Agent Host. Para configurações compartilhadas com o Agent Host ou outras ferramentas Copilot, use um .mcp.json de workspace ou ~/.copilot/mcp-config.json de usuário e evite entradas interativas.

Cline

Documentação oficial: MCP.

No painel do Cline, abra MCP Servers > Configure > Configure MCP Servers, ou adicione um endpoint hospedado na aba Remote Servers. Use o tipo explícito streamableHttp; omiti-lo faz com que o comportamento SSE legado seja usado.

{
  "mcpServers": {
    "anysearch": {
      "type": "streamableHttp",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

O IDE do Cline suporta ${env:VAR} em url, headers e env. Execute cline mcp para abrir o assistente CLI, ou cline config mcp --json para listar a configuração. A documentação web oficial ainda nomeia ~/.cline/mcp.json, enquanto o código-fonte atual usa como padrão ~/.cline/data/settings/cline_mcp_settings.json; use Configure MCP Servers no IDE ou o assistente CLI para abrir o arquivo efetivo em vez de depender de um caminho fixo.

As cinco entradas a seguir foram verificadas em relação à documentação de configuração de primeira parte em 27/08/2026. Isso estabelece compatibilidade documentada do cliente, não uma certificação de conexão local de ponta a ponta.

OpenAI Codex

Documentação oficial: Model Context Protocol.

Use ~/.codex/config.toml globalmente ou .codex/config.toml em um projeto confiável. O CLI do Codex, a extensão do IDE e o aplicativo de desktop compartilham esta configuração:

[mcp_servers.anysearch]
url = "https://api.anysearch.com/mcp"
bearer_token_env_var = "ANYSEARCH_API_KEY"
http_headers = { "X-Anysearch-Client" = "mcp/1.0.0" }

Defina ANYSEARCH_API_KEY antes de iniciar o Codex. Para acesso anônimo, remova bearer_token_env_var. Execute codex mcp list, ou use /mcp dentro do TUI do Codex, para confirmar que o servidor e suas ferramentas estão disponíveis.

Google Antigravity

Documentação oficial: Servidores MCP no Antigravity.

Use ~/.gemini/config/mcp_config.json globalmente ou .agents/mcp_config.json em um workspace. Servidores remotos devem usar serverUrl; as chaves legadas url e httpUrl não são suportadas:

{
  "mcpServers": {
    "anysearch": {
      "serverUrl": "https://api.anysearch.com/mcp",
      "headers": {
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

A documentação oficial do Antigravity atualmente mostra valores literais de cabeçalho personalizado, mas não documenta interpolação de variável de ambiente para cabeçalhos remotos. Se a autenticação for necessária, adicione "Authorization": "Bearer YOUR_API_KEY" apenas ao arquivo global privado e nunca o commite em .agents/mcp_config.json. Abra MCP Servers > Manage MCP Servers no IDE, ou execute /mcp no CLI, para inspecionar status ao vivo, logs e ferramentas.

DeepSeek Harness

Fontes oficiais: DeepSeek Harness e @deepseek-ai/dsh-mcp-client.

O DeepSeek Harness configura MCP por meio de seu plugin Cordis de primeira parte, em vez de um mcp.json autônomo. Mescle este patch em ~/.dsh/profiles/web/cordis.patch.yml (ou no perfil correspondente em $DSH_HOME):

- insert:
    - id: mcp-anysearch
      name: "@deepseek-ai/dsh-mcp-client"
      config:
        serverName: anysearch
        transport: streamable-http
        url: "https://api.anysearch.com/mcp"
        headers:
          Authorization: !!js '`Bearer ${process.env.ANYSEARCH_API_KEY}`'
          X-Anysearch-Client: "mcp/1.0.0"
        failOnStartupError: true

Defina ANYSEARCH_API_KEY e execute npx @deepseek-ai/dsh --profile web --dump-config para verificar se o perfil inclui mcp-anysearch antes de iniciá-lo com npx @deepseek-ai/dsh web. O plugin MCP atual expõe apenas ferramentas; recursos e prompts MCP ainda não são suportados. O DeepSeek Harness é uma prévia para desenvolvedores, então verifique novamente a documentação do plugin vinculado ao atualizar.

Hermes Agent

Documentação oficial: Integração MCP.

Adicione o servidor a $HERMES_HOME/config.yaml e armazene ANYSEARCH_API_KEY em $HERMES_HOME/.env ou no ambiente do processo. No macOS e Linux, $HERMES_HOME usa como padrão ~/.hermes; o instalador nativo do Windows atualmente usa como padrão %LOCALAPPDATA%\hermes:

mcp_servers:
  anysearch:
    url: "https://api.anysearch.com/mcp"
    headers:
      Authorization: "Bearer ${ANYSEARCH_API_KEY}"
      X-Anysearch-Client: "mcp/1.0.0"

Verifique com hermes mcp test anysearch e hermes mcp list. Após editar a configuração durante uma sessão, execute /reload-mcp ou inicie uma nova sessão.

OMP (Oh My Pi)

Documentação oficial: Configuração MCP.

Use .omp/mcp.json em um projeto ou ~/.omp/agent/mcp.json globalmente:

{
  "$schema": "https://raw.githubusercontent.com/can1357/oh-my-pi/main/packages/coding-agent/src/config/mcp-schema.json",
  "mcpServers": {
    "anysearch": {
      "type": "http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

O OMP expande ${VAR} e ${VAR:-default} em valores de configuração. Defina ANYSEARCH_API_KEY e execute /mcp reload, /mcp test anysearch e /mcp list dentro do OMP.

Referência Rápida do Cliente

Cliente	Conexão oficial	Local de configuração	Streamable HTTP direto?
OpenCode	Config MCP remota	`~/.config/opencode/opencode.json` ou projeto `opencode.json`	Sim
Claude Code	MCP HTTP remoto	Usuário `~/.claude.json` ou projeto `.mcp.json`	Sim
Cursor	Config MCP remota	`.cursor/mcp.json` ou `~/.cursor/mcp.json`	Sim
VS Code	Config MCP HTTP	Config de usuário local ou `.vscode/mcp.json`; Agent Host usa `.mcp.json` / `~/.copilot/mcp-config.json`	Sim
Cline	Streamable HTTP remoto	Abra a configuração efetiva pelo IDE do Cline ou assistente CLI	Sim
OpenAI Codex	Config MCP remota	`~/.codex/config.toml` ou projeto confiável `.codex/config.toml`	Sim
Google Antigravity	Config MCP remota usando `serverUrl`	`~/.gemini/config/mcp_config.json` ou workspace `.agents/mcp_config.json`	Sim
DeepSeek Harness	Plugin de cliente MCP de primeira parte	`$DSH_HOME/profiles/<name>/cordis.patch.yml`	Sim
Hermes Agent	MCP HTTP remoto	`$HERMES_HOME/config.yaml`	Sim
OMP (Oh My Pi)	Config MCP HTTP	`.omp/mcp.json` ou `~/.omp/agent/mcp.json`	Sim

Ferramentas Disponíveis

`search`

Execute uma consulta de busca — geral ou por domínio vertical.

Parâmetro	Tipo	Obrigatório	Descrição
`query`	string	Sim	Consulta de busca em linguagem natural. UMA intenção por chamada
`domain`	string	Não	Domínio vertical (ex.: `finance`, `academic`, `security`). Deve vir do enum `get_sub_domains`
`sub_domain`	string	Não	Chave de roteamento de subdomínio (ex.: `finance.us_stock`). Deve vir da saída de `get_sub_domains`
`sub_domain_params`	object	Não	Parâmetros estruturados da coluna de parâmetros de `get_sub_domains`. NUNCA invente valores
`max_results`	integer	Não	1–10, padrão 10

`get_sub_domains`

Consulte o diretório de domínios verticais. Obrigatório antes de qualquer busca que use um domínio — retorna sub_domains válidos e seus esquemas de parâmetros.

Parâmetro	Tipo	Obrigatório	Descrição
`domain`	string	Um de	Domínio único a consultar
`domains`	string[]	Um de	Lote de até 5 domínios (preferido — cobre mais terreno)

Retorna uma tabela Markdown: sub_domain | description | params

`batch_search`

Execute 1–5 consultas de busca independentes em paralelo. Uma falha isolada não bloqueia as demais.

Parâmetro	Tipo	Obrigatório	Descrição
`queries`	object[]	Sim	1–5 objetos de consulta, cada um com os mesmos campos de `search`

`extract`

Busque o conteúdo completo de uma página a partir de uma URL e retorne como Markdown. Truncado em 50.000 caracteres. Apenas páginas HTML.

Parâmetro	Tipo	Obrigatório	Descrição
`url`	string	Sim	URL de destino (`http://` ou `https://`)