Communitygithub.com

iamvtor/opencode-setup

Recherche sur les sites personnels et blogs à l'aide de la recherche avancée Exa. Prise en charge complète des filtres pour trouver des perspectives individuelles, des portfolios et des blogs personnels. À utiliser lors de la recherche de sites personnels, d'articles de blog ou de sites portfolio.

Qu'est-ce que opencode-setup ?

Cette compétence permet aux agents d'IA (comme Claude Code, Cursor ou Codex) d'effectuer des recherches ciblées sur les sites personnels et blogs à l'aide du SDK Python Exa. Elle est particulièrement utile pour trouver des perspectives individuelles, des portfolios et des blogs indépendants, en contournant les agrégateurs. La compétence prend en charge une large gamme de paramètres de recherche, notamment le filtrage par domaine, les plages de dates, la recherche en texte intégral, les surlignages, les résumés, et même la récupération de contenu frais via `livecrawl`. Elle fonctionne en exécutant du code Python dans un agent de tâche via `ctx_execute`, garantissant que la logique de recherche reste isolée et que seul le résultat distillé est renvoyé. Pour l'utiliser, vous devez définir la variable d'environnement `EXA_API_KEY` et installer le paquet `exa-py`.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Recherche sur sites personnels (SDK Python Exa)

Prérequis

uv pip install exa-py

Définissez la variable d'environnement EXA_API_KEY. Obtenez une clé sur https://dashboard.exa.ai/api-keys

Approche

Utilisez ctx_execute(language: "python", code: "...") pour appeler Exa. N'exécutez jamais de recherches Exa dans le contexte principal — créez toujours des agents de tâche qui ne renvoient qu'un résultat distillé.

Paramètres pris en charge

La catégorie personal site prend en charge tous les paramètres disponibles :

from exa_py import Exa
import os, json

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

response = exa.search(
    "construire des projets annexes parcours indie hacking 2025",
    num_results=15,
    category="personal site",
    type="auto",
    exclude_domains=["medium.com"],  # exclure les agrégateurs pour les blogs indépendants
    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))

Prise en charge complète des paramètres

  • query (obligatoire)
  • 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 (tableaux à un seul élément ; plusieurs éléments provoquent une erreur 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} pour le contenu frais

Skills associés