AI Finder Kit Search

O que AI Finder Kit Search faz?

Versão: 1.3.1

Use o cliente livre de dependências incluso para consultar o serviço de busca agregada autenticado. Para instalação local interativa, execute configure para armazenar a chave em um arquivo protegido; para automação, injete AIFINDERKIT_API_KEY. Nunca coloque uma chave em prompts, saída de comandos, arquivos fonte ou arquivos de skill.

Requisitos

• Python 3.10 ou superior com acesso HTTPS de saída.
• Uma chave de busca ou proprietário válida do AI Finder Kit em AIFINDERKIT_API_KEY ou no arquivo de credencial protegido criado por configure.
• Nenhum pacote Python extra. Este pacote de skill intencionalmente não contém credenciais.

Antes da primeira busca, execute python scripts/aifinderkit_search.py doctor. Ele verifica Python, autenticação, a versão da API, endpoints disponíveis e limites atuais sem exibir a chave.

Fluxo de Trabalho

1. Execute doctor quando o acesso não tiver sido verificado no ambiente atual.
2. Escolha a menor operação que atenda à solicitação:
   • search: uma consulta com resultados normalizados e deduplicados.
   • domains: descubra subdomínios verticais válidos do AnySearch antes de uma busca estruturada.
   • batch: duas a cinco consultas independentes.
   • fetch: texto legível de uma página pública HTTP(S) conhecida.
   • map: descubra uma lista limitada de links em uma única página estática.
   • crawl: extraia uma pequena seção do mesmo host, nunca uma varredura ampla do site.
   • research: coleta de evidências com múltiplas consultas, extração, cobertura e detecção de lacunas.
   • Para trabalho acadêmico, use --preset academic-strict; use academic-relaxed apenas quando páginas de projeto e relatórios técnicos não acadêmicos também forem úteis. O modo relaxado troca precisão por revocação, portanto inspecione retrieval_signals.query_relevance e descarte correspondências fracas.
   • meta: nível de acesso atual e limites de requisição.
3. Execute scripts/aifinderkit_search.py.
4. Use retrieval_score com seus retrieval_signals ao julgar a qualidade da recuperação. O score de fusão é apenas um valor de classificação do provedor. confidence é um alias obsoleto para retrieval_score e nunca representa verdade factual.
5. Cite as URLs das páginas retornadas na resposta ao usuário. Trate os trechos como auxílios de descoberta; use fetch ou a página principal antes de fazer afirmações precisas.
6. Para comparações ou afirmações consequentes, exija uma fonte primária ou concordância entre duas fontes independentes. Não trate confidence como verificação factual; é um sinal de recuperação.

Comandos

python scripts/aifinderkit_search.py search "consulta" --limit 10 --mode balanced
python scripts/aifinderkit_search.py search "consulta" --language zh --category news
python scripts/aifinderkit_search.py search "consulta" --include-domain github.com
python scripts/aifinderkit_search.py domains --domain academic --domain code
python scripts/aifinderkit_search.py search "transformer" --vertical-domain academic --vertical-sub-domain academic.search
python scripts/aifinderkit_search.py search "aprendizado multimodal" --preset academic-strict --mode deep
python scripts/aifinderkit_search.py research "avaliação de recuperação aumentada por geração" --preset academic-strict --fetch-top 5
python scripts/aifinderkit_search.py batch --query "artigo um" --query "artigo dois" --preset academic-relaxed --limit 5
python scripts/aifinderkit_search.py fetch "https://example.com/page"
python scripts/aifinderkit_search.py map "https://example.com/docs" --max-links 30
python scripts/aifinderkit_search.py crawl "https://example.com/docs" --max-pages 5 --max-depth 1
python scripts/aifinderkit_search.py research "tópico" --subquery "história" --subquery "evidências atuais" --fetch-top 3
python scripts/aifinderkit_search.py meta
python scripts/aifinderkit_search.py configure
secret-manager-command | python scripts/aifinderkit_search.py configure --key-stdin
python scripts/aifinderkit_search.py doctor

Use fast para descoberta sensível à latência, balanced como padrão e deep para pesquisa. Adicione --freshness day|week|month|year apenas quando a solicitação for limitada por tempo. O timeout do cliente é de 60 segundos por padrão; para pesquisa com múltiplos PDFs, coloque --timeout 120 antes do nome do comando.

Para domínios financeiro, acadêmico, código, saúde, jurídico, segurança, viagens e outros domínios estruturados do AnySearch, execute domains primeiro. Copie apenas um sub_domain retornado e inclua todos os parâmetros necessários com --vertical-param key=value; use um valor vazio quando o diretório marcar um parâmetro obrigatório, mas nenhum se aplicar. Se domains retornar 403, continue com a busca agregada comum em vez de inventar um esquema vertical.

Quando a Etapa 2 do Fluxo de Trabalho for uma revisão de literatura, siga references/academic-research.md em vez do caminho de busca comum. Os presets acadêmicos usam mecanismos acadêmicos especializados, expõem metadados DOI/autor/ano/acesso aberto quando disponíveis e evitam fallbacks da web geral no modo estrito. Leia references/api.md antes de consumir programaticamente o objeto academic.

Use map antes de crawl. Mantenha os padrões de crawl a menos que o usuário precise de uma seção específica e pequena da documentação. crawl é HTML estático, mesmo host, no máximo oito páginas e profundidade dois; não é uma ferramenta de automação de navegador.

Para pesquisa aprofundada, leia references/research-workflow.md antes de escolher subconsultas ou interpretar coverage e gaps. Para seleção de fontes e verificações de citação, leia references/source-quality.md.

Se o script empacotado não estiver no diretório de trabalho atual, resolva-o relativo a este SKILL.md em vez de assumir que scripts/ existe no projeto do usuário.

O cliente primeiro verifica AIFINDERKIT_API_KEY para uma chave inline. Se não estiver definida, o cliente lê o arquivo protegido selecionado por AIFINDERKIT_API_KEY_FILE, ou ~/.config/aifinderkit/credentials por padrão. O configure interativo lê sem eco; configure --key-stdin suporta pipelines de gerenciadores de segredos. Ambos escrevem em modo 0600 fora do Skill e do projeto atual. Nunca passe uma chave como argumento de linha de comando.

Se um endpoint retornar 401, peça ao usuário para configurar uma chave de busca válida. Se retornar 429, informe o limite e não faça repetições de tentativas. Se warnings disser que uma fonte não está disponível, afirme que o conjunto de resultados foi degradado em vez de implicar agregação completa.

Leia references/api.md apenas quando esquemas exatos, mapeamentos de endpoint ou comportamento de erro forem necessários.