wawa1154/kagi-skills

O que kagi-skills faz?

Permite que agentes de IA acessem as APIs de busca e IA do Kagi para pesquisa web, resumos e respostas enriquecidas por meio de ferramentas CLI simples.

Visão Geral

Esta skill expõe um conjunto de utilitários de linha de comando que agentes de IA (como Claude Code, Cursor, Codex e outros) podem utilizar para consultar a web através do motor de busca Kagi. Ela inclui comandos para pesquisa web, resumo de páginas e obtenção de respostas enriquecidas com fontes.

Pré-requisitos

• Uma chave de API do Kagi (obtenha uma em kagi.com)
• As ferramentas CLI instaladas no ambiente onde o agente está sendo executado

Instalação

1. Clone o repositório:

   git clone https://github.com/wawa1154/kagi-skills.git
   cd kagi-skills
   

2. Instale as dependências:

   pip install -r requirements.txt
   

3. Configure sua chave de API do Kagi como uma variável de ambiente:

   export KAGI_API_KEY="sua_chave_api_aqui"
   

Comandos Disponíveis

kagi-search

Realiza uma pesquisa web utilizando o motor de busca Kagi e retorna os resultados em formato JSON.

Uso:

kagi-search "sua consulta de pesquisa"

Exemplo:

kagi-search "últimas notícias sobre inteligência artificial"

kagi-summarize

Obtém um resumo de uma ou mais URLs fornecidas. Útil para agentes que precisam extrair rapidamente a essência de uma página web.

Uso:

kagi-summarize <url1> [url2 ...]

Exemplo:

kagi-summarize "https://exemplo.com/artigo"

kagi-answer

Submete uma pergunta e obtém uma resposta enriquecida com fontes confiáveis, similar à funcionalidade "Quick Answer" do Kagi.

Uso:

kagi-answer "sua pergunta aqui"

Exemplo:

kagi-answer "Qual é a capital do Brasil?"

Configuração

Todas as ferramentas requerem que a variável de ambiente KAGI_API_KEY esteja definida com uma chave de API válida. Recomenda-se adicionar essa variável ao seu ambiente de desenvolvimento ou arquivo de configuração do agente (por exemplo, .env para Claude Code).

Integração com Agentes

Esta skill é projetada para ser facilmente consumida por agentes de IA. Os comandos retornam saída em JSON estruturado, facilitando a análise e uso pelo agente. Para agentes como Claude Code ou Cursor, você pode instruir o agente a usar esses comandos para buscar informações adicionais quando necessário.

Exemplo de instrução para o agente:

"Quando precisar de informações atualizadas, use o comando kagi-search para pesquisar na web. Se encontrar um artigo relevante, use kagi-summarize para extrair um resumo."

Solução de Problemas

• Erro de chave de API: Certifique-se de que a variável de ambiente KAGI_API_KEY está definida corretamente.
• Comando não encontrado: Verifique se as ferramentas CLI estão instaladas e acessíveis no PATH do sistema.
• Limite de taxa: O Kagi pode impor limites de taxa dependendo do seu plano de assinatura. Consulte a documentação do Kagi para mais detalhes.

Licença

Este projeto está licenciado sob a licença MIT - consulte o arquivo LICENSE para mais detalhes.