Communitygithub.com

Pesquisa em Sites Pessoais (Exa Python SDK)

Pesquise sites pessoais e blogs usando a busca avançada do Exa. Suporte completo a filtros para encontrar perspectivas individuais, portfólios e blogs pessoais. Use ao buscar sites pessoais, postagens de blog ou sites de portfólio.

O que é Pesquisa em Sites Pessoais (Exa Python SDK)?

Esta skill permite que agentes de IA (como Claude Code) pesquisem sites pessoais e blogs independentes utilizando a API do Exa, um mecanismo de busca especializado em conteúdo de alta qualidade. Ela oferece suporte completo a todos os parâmetros disponíveis na API Exa, como filtros por domínio (incluir/excluir), intervalo de datas de publicação, tipos de busca (auto, fast, deep, etc.), e opções avançadas de conteúdo como destaques e sumários. A skill é particularmente útil para encontrar perspectivas únicas, portfólios, blogs pessoais e projetos side-project, evitando agregadores de conteúdo como medium.com. Utiliza-se chamando a função `ctx_execute` com código Python que importa a biblioteca `exa_py` e configura a chave `EXA_API_KEY`. A abordagem recomendada é executar as pesquisas em tarefas (Task agents) separadas, não no contexto principal, para obter resultados destilados e eficientes.

Funciona com~Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/iamvtor/opencode-setup/tree/HEAD/skills/exa-personal-site-search

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Pesquisa em Sites Pessoais (Exa Python SDK) faz?

Pré-requisitos

uv pip install exa-py

Defina a variável de ambiente EXA_API_KEY. Obtenha uma chave em https://dashboard.exa.ai/api-keys

Abordagem

Use ctx_execute(language: "python", code: "...") para chamar o Exa. Nunca execute pesquisas Exa no contexto principal — sempre crie agentes de tarefa que retornem apenas saída destilada.

Parâmetros Suportados

A categoria personal site suporta TODOS os parâmetros disponíveis:

from exa_py import Exa
import os, json

exa = Exa(os.environ["EXA_API_KEY"])

response = exa.search(
    "criando projetos paralelos jornada indie hacking 2025",
    num_results=15,
    category="personal site",
    type="auto",
    exclude_domains=["medium.com"],  # exclui agregadores para blogs independentes
    contents={"highlights": True}
)

results = []
for r in response.results:
    results.append({
        "title": r.title,
        "url": r.url,
        "highlights": getattr(r, 'highlights', [])
    })
print(json.dumps(results, indent=2))

Suporte Completo a Parâmetros

  • query (obrigatório)
  • num_results
  • type ("auto", "fast", "instant", "deep-lite", "deep", "deep-reasoning")
  • include_domains / exclude_domains
  • start_published_date / end_published_date (ISO 8601)
  • start_crawl_date / end_crawl_date (ISO 8601)
  • include_text / exclude_text (apenas arrays de um único item; múltiplos itens causa erro 400)
  • contents={"text": {"max_characters": N}}
  • contents={"highlights": True} / contents={"highlights": {"query": "..."}}
  • contents={"summary": True} / contents={"summary": {"query": "..."}}
  • user_location
  • moderation
  • additional_queries
  • contents={"livecrawl_timeout": 10000, "max_age_hours": 0} para conteúdo recente

Habilidades Relacionadas