TheAgent Vendors: documentação para agentes

Comece pelo catálogo público

As páginas públicas do catálogo podem ser consultadas sem cadastro. Envie Accept: text/markdown para receber Markdown na mesma URL, ou Accept: text/html para receber a página HTML. A resposta indica o formato em Content-Type e inclui Vary: Accept.

curl -sS -H 'Accept: text/markdown' 'https://theagent.bz/vendors/'

Descubra os perfis publicados pelo sitemap ou pelo índice de perfis. Use os slugs encontrados nesses links em /concorrentes?vendors=slug1,slug2 para comparar de duas a quatro empresas. Os valores slug1 e slug2 são exemplos: substitua-os por perfis reais.

Preserve a URL canônica, as fontes e a data apresentada no perfil ao citar uma informação. Ausência de informação não comprova ausência de uma capacidade do fornecedor. Consulte a metodologia e as instruções para agentes antes de usar os dados.

Conecte o TheAgent Pro

Para consultar o TheAgent Pro dentro de um cliente MCP, configure o endereço https://mcp.theagent.bz com transporte Streamable HTTP e autenticação OAuth. O MCP é um serviço separado do catálogo público.

1. Acesse as instruções de instalação do TheAgent Pro para o seu aplicativo.
2. Adicione o servidor ao cliente e conclua o login e a autorização na janela apresentada.
3. Peça ao agente: “Use o TheAgent Pro e me diga o status da minha conta.”

O cliente descobre a autenticação pelo cabeçalho WWW-Authenticate da resposta 401 e pelos metadados públicos OAuth. Após a autorização, use tools/list para descobrir as ferramentas e seus schemas e tools/call conforme o protocolo negociado pelo cliente. Não presuma acesso a uma ferramenta antes de conferir a conta e as permissões concedidas.

O TheAgent Pro oferece sete dias sem cobrança; confira as condições e o preço vigente na página do serviço antes de assinar. O acesso público às páginas deste catálogo não exige essa assinatura.

Respostas e limites de acesso

• 404: página não encontrada; consulte o sitemap ou o llms.txt.
• 410: registro removido; não o apresente como fornecedor disponível no catálogo.
• 406: nenhum dos formatos oferecidos foi aceito; solicite HTML ou Markdown.
• 401 no MCP: autenticação necessária ou token inválido; siga o fluxo OAuth do cliente.
• 429: limite de acesso; reduza a frequência e respeite Retry-After quando informado.

Respeite robots.txt e os limites do serviço. Não envie formulários automaticamente sem autorização do usuário. Para dúvidas sobre a integração ou correções no catálogo, use o canal de contato.