Communitygithub.com

iamvtor/opencode-setup

Busca sitios web y blogs personales usando la búsqueda avanzada de Exa. Soporte completo de filtros para encontrar perspectivas individuales, portafolios y blogs personales. Úsalo cuando busques sitios personales, entradas de blog o sitios de portafolio.

¿Qué es opencode-setup?

Esta skill permite a agentes de IA, como Claude Code, Cursor y Codex, buscar en sitios web personales y blogs utilizando el SDK de Python de Exa. Se enfoca en contenido de fuentes individuales (no agregadores como Medium) y soporta un rango completo de filtros: dominio, fecha de publicación, texto incluido/excluido, resúmenes, destacados y más. Para usarla correctamente, el agente debe ejecutar consultas dentro de un agente Task secundario usando `ctx_execute(language: "python", code: "...")`, nunca en el contexto principal. Requiere la variable de entorno `EXA_API_KEY` y la instalación de la biblioteca `exa-py`. Es ideal para tareas como encontrar portafolios, artículos personales o documentar viajes de desarrollo independiente.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Búsqueda en sitios personales (Exa Python SDK)

Prerrequisitos

uv pip install exa-py

Establece la variable de entorno EXA_API_KEY. Obtén una en https://dashboard.exa.ai/api-keys

Enfoque

Usa ctx_execute(language: "python", code: "...") para llamar a Exa. Nunca ejecutes búsquedas de Exa en el contexto principal; siempre lanza agentes Task que devuelvan solo la salida destilada.

Parámetros compatibles

La categoría personal site soporta TODOS los parámetros disponibles:

from exa_py import Exa
import os, json

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

response = exa.search(
    "building side projects indie hacking journey 2025",
    num_results=15,
    category="personal site",
    type="auto",
    exclude_domains=["medium.com"],  # excluye agregadores para blogs independientes
    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))

Soporte completo de parámetros

  • query (requerido)
  • 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 (arreglos de un solo elemento; múltiples elementos causan error 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 contenido fresco

Skills relacionados