Communitygithub.com

sasakiblog26-lgtm/exa-mcp-server

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

O que é exa-mcp-server?

Esta skill permite que agentes de IA realizem buscas avançadas na web, restritas à categoria de **sites pessoais**, utilizando o mecanismo Exa. Ela é ideal para obter opiniões individuais, experiências de especialistas, tutoriais práticos e análises independentes, evitando conteúdo corporativo. A skill oferece suporte completo a filtros, incluindo domínio, data, texto e extração de conteúdo, mas impõe uma restrição importante: os parâmetros `includeText` e `excludeText` aceitam apenas arrays de um único item para evitar erros 400. Para isolar o contexto principal do agente, a skill exige que todas as buscas Exa sejam executadas em **agentes Task** separados, que processam, mesclam e deduplicam os resultados antes de apresentá-los de forma condensada. Compatível com qualquer plataforma que suporte o protocolo MCP, esta skill é essencial para desenvolvedores que precisam acessar rapidamente conteúdo de alta qualidade e autoral na web, mantendo a eficiência e a organização do agente principal.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sasakiblog26-lgtm/exa-mcp-server/tree/HEAD/skills/personal-site-search

Perguntar na sua IA favorita

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

Documentação

Pesquisa Web Avançada - Categoria Site Pessoal

Restrição de Ferramenta (Crítico)

Use APENAS web_search_advanced_exa com category: "personal site". Não use outras categorias ou ferramentas.

Suporte Completo a Filtros

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

Núcleo

  • query (obrigatório)
  • numResults
  • type ("auto", "fast", "deep", "neural")

Filtragem de domínio

  • includeDomains
  • excludeDomains (por exemplo, exclua Medium se quiser blogs independentes)

Filtragem por data (ISO 8601)

  • startPublishedDate / endPublishedDate
  • startCrawlDate / endCrawlDate

Filtragem de texto

  • includeText (deve conter TODOS)
  • excludeText (excluir se QUALQUER um corresponder)

Restrição de tamanho de array: includeText e excludeText suportam apenas arrays de item único. Arrays com múltiplos itens (2+ itens) causam erros 400. Para corresponder a vários termos, coloque-os na string query ou execute buscas separadas.

Extração de conteúdo

  • textMaxCharacters / contextMaxCharacters
  • enableSummary / summaryQuery
  • enableHighlights / highlightsNumSentences / highlightsPerUrl / highlightsQuery

Adicionais

  • additionalQueries
  • maxAgeHours / livecrawlTimeout
  • subpages / subpageTarget - útil para explorar sites de portfólio

Isolamento de Token (Crítico)

Nunca execute buscas Exa no contexto principal. Sempre instancie agentes Task:

  • O agente chama web_search_advanced_exa com category: "personal site"
  • O agente mescla + deduplica os resultados antes de apresentar
  • O agente retorna uma saída destilada (markdown resumido ou JSON compacto)
  • O contexto principal permanece limpo independentemente do volume de busca

Quando Usar

Use esta categoria quando precisar de:

  • Opiniões e experiências individuais de especialistas
  • Postagens de blogs pessoais sobre tópicos técnicos
  • Sites de portfólio
  • Análises independentes (não conteúdo corporativo)
  • Mergulhos profundos e tutoriais de profissionais

Exemplos

Postagens de blog técnico:

web_search_advanced_exa {
  "query": "lições aprendidas construindo aplicações LLM em produção",
  "category": "personal site",
  "numResults": 15,
  "type": "deep",
  "enableSummary": true
}

Postagens recentes sobre um tópico:

web_search_advanced_exa {
  "query": "comparação de runtime Rust async",
  "category": "personal site",
  "startPublishedDate": "2025-01-01",
  "numResults": 10,
  "type": "auto"
}

Excluir agregadores:

web_search_advanced_exa {
  "query": "lições de fundador de startup",
  "category": "personal site",
  "excludeDomains": ["medium.com", "substack.com"],
  "numResults": 15,
  "type": "auto"
}

Formato de Saída

Retorne:

  1. Resultados (título, autor/nome do site, data, principais insights)
  2. Fontes (URLs)
  3. Notas (expertise do autor, possíveis vieses, profundidade da cobertura)

Habilidades Relacionadas