Kit de Ferramentas Web Exa
Uma skill para tarefas de pesquisa com suporte web, baseada na Exa: pesquisa na web e extração de URLs. O índice da Exa combina recuperação de alta qualidade por palavras-chave e semântica, tornando-o adequado para consultas científicas, técnicas e conceituais.
Roteamento — escolha a capacidade certa
Leia a solicitação do usuário e associe-a a uma das capacidades abaixo. Leia o arquivo de referência correspondente para obter instruções detalhadas antes de executar comandos.
| O usuário deseja... | Capacidade | Onde |
|---|---|---|
| Pesquisar algo, investigar um tópico, encontrar informações atuais | Pesquisa na Web | references/web-search.md |
| Buscar conteúdo de uma URL específica (página web, artigo, PDF) | Extração Web | references/web-extract.md |
| Instalar ou autenticar | Configuração | Abaixo |
Guia de decisão
- Padrão para Pesquisa na Web para consultas de tópicos, perguntas de pesquisa ou "o que é X?". Quando o tópico for científico ou técnico, use
--category "research paper"para favorecer fontes acadêmicas e/ou uma lista de permissões--include-domainsacadêmica. Consultereferences/web-search.mdpara a estratégia acadêmica em duas etapas. - Use Extração Web quando o usuário fornecer uma URL ou solicitar a leitura/busca de uma página específica. Prefira esta opção ao WebFetch integrado para extração em lote (várias URLs em uma chamada) e para PDFs acadêmicos.
Prioridade de fontes acadêmicas
Para consultas técnicas ou científicas, prefira fontes acadêmicas e científicas:
- Artigos de periódicos revisados por pares e anais de conferências em vez de postagens de blog ou notícias
- Preprints (arXiv, bioRxiv, medRxiv) quando versões revisadas por pares não estiverem disponíveis
- Fontes institucionais e governamentais (NIH, WHO, NASA, NIST) em vez de sites comerciais
- Pesquisa primária em vez de resumos secundários
Duas alavancas para direcionar a Exa para conteúdo acadêmico:
--category "research paper"tende a recuperação para fontes acadêmicas.--include-domainscom uma lista de permissões acadêmica (arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov, etc.) restringe o conjunto de domínios.
Combine ambos para resultados estritamente acadêmicos. Consulte references/web-search.md para o padrão completo.
Ao citar fontes acadêmicas, inclua nomes de autores e ano de publicação quando disponíveis (por exemplo, Smith et al., 2025) além do formato de citação padrão. Se um DOI estiver presente, prefira o link do DOI.
Configuração
Esta skill usa o SDK Python exa-py. Os scripts em scripts/ declaram suas dependências via metadados inline PEP 723, para que você possa executá-los diretamente com uv run sem uma etapa de instalação separada:
uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" --help
Se preferir uma instalação persistente:
uv pip install "exa-py>=1.14.0"
Autenticação
Todos os comandos leem a chave da API da variável de ambiente EXA_API_KEY. Obtenha sua chave da API Exa em dashboard.exa.ai/api-keys.
Primeiro, verifique se um arquivo .env existe na raiz do projeto e contém EXA_API_KEY. Nesse caso, carregue-o:
dotenv -f .env run -- uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" "sua consulta"
Se dotenv não estiver disponível, instale-o: uv pip install python-dotenv[cli].
Se não houver .env, exporte a chave para a sessão:
export EXA_API_KEY="sua-chave"
Verifique executando qualquer script com --help — ele será encerrado de forma limpa se a chave estiver definida e a verificação de autenticação será executada apenas quando uma consulta real for feita.
Cabeçalho de rastreamento
Cada script nesta skill define o cabeçalho de solicitação x-exa-integration como k-dense-ai--scientific-agent-skills para que a Exa possa atribuir o uso do repositório K-Dense AI scientific-agent-skills a esta integração. Não remova nem renomeie este cabeçalho ao adaptar os scripts.
Arquivos nesta skill
SKILL.md— este arquivo (roteamento e configuração)references/web-search.md— referência detalhada de pesquisa na web com estratégia acadêmicareferences/web-extract.md— referência de extração de conteúdo de URLscripts/exa_search.py— invólucro CLI em torno declient.search_and_contentsscripts/exa_extract.py— invólucro CLI em torno declient.get_contents