Yoyiyoniu/paper-search

Recherche dans les API savantes officielles (arXiv, Semantic Scholar, Europe PMC, OpenAlex), lit le PDF légal et rédige une note citée à partir de ces articles. À utiliser lorsque l'utilisateur demande des articles scientifiques, une revue de littérature, un état de l'art, des preuves sur un sujet, un DOI connu, ou dit « cherche des articles sur X », même sans utiliser le mot « article ».

Qu'est-ce que paper-search ?

Cette compétence permet à un agent IA de rechercher et lire des articles scientifiques en utilisant des API officielles comme arXiv, Semantic Scholar, Europe PMC et OpenAlex, en fonction du domaine de la requête. Contrairement aux simples recherches web, elle s'assure que seules les affirmations provenant des résumés ou du PDF lu pendant la session sont utilisées, évitant ainsi les informations de mémoire ou de sources secondaires. Elle délègue la lecture des revues de littérature à un agent d'arrière-plan pour ne pas bloquer la conversation, et produit une note formatée avec des citations (auteur, année, DOI, source). La compétence inclut un script Python (`scripts/papers.py`) sans dépendances externes, capable de rechercher, lire des PDF (via Unpaywall) et gérer les tris par pertinence, citations ou date. L'utilisateur peut configurer une clé API Semantic Scholar et un email pour réduire les limitations de taux et améliorer l'accès aux données.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yoyiyoniu/my-skills/tree/HEAD/paper-search

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

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

Documentation

Que fait paper-search ?

Recherche dans les API officielles et lit le PDF légal. Une affirmation scientifique n'est autorisée que si le résumé ou les pages PDF lues dans cette session la contiennent. Ne la fournissez pas de mémoire, d'un blog ou de toute autre publication secondaire. Rattachez chaque affirmation à l'article qui la possède.

L'année, le DOI et le nombre de citations proviennent de la sortie du script. Si citations=-, la source n'a pas fourni de décompte. Dites-le. Ne l'estimez pas.

Déléguer la lecture

Pour une revue de littérature, un état de l'art ou tout rapport nécessitant plus d'un article, lancez un agent d'arrière-plan pour faire la lecture afin que cette conversation puisse continuer. Un seul article ou un DOI connu reste ici.

Le travail de l'agent d'arrière-plan :

  1. Investiguer la question à partir des articles eux-mêmes, pas d'une publication secondaire à leur sujet.
  2. Écrire les résultats dans un seul fichier Markdown, en citant la source de chaque affirmation.
  3. Le sauvegarder là où le dépôt conserve déjà ce genre de notes. Respectez la convention existante. S'il n'y en a pas, écrivez docs/notes/<sujet>.md et dites où.

Donnez-lui le chemin absolu vers scripts/papers.py, la question, le domaine et le chemin de sortie. Il utilise le script ci-dessous et ne réimplémente pas les API.

Script

scripts/papers.py se trouve à côté de ce fichier. Uniquement la bibliothèque standard. Exécutez-le par chemin absolu.

python3 scripts/papers.py search "QUERY" [--domain auto|ml|phys|math|bio|psy|chem] [--limit N] [--year 2020|2020-2024|2020-] [--sort relevance|citations|date] [--abstract]
python3 scripts/papers.py read PDF_URL --pages 1-3 [--out notes.txt]
python3 scripts/papers.py oa 10.xxxx/yyyy

oa affiche is_oa= et pdf= depuis Unpaywall. Une seule requête, --limit au maximum 10. Si la liste de résultats est erronée, modifiez la requête. Ne paginez pas.

Optionnel : SEMANTIC_SCHOLAR_API_KEY (moins de 429) et PAPER_SEARCH_EMAIL (OpenAlex et Unpaywall).

Routage

Traduisez la requête en anglais avant de chercher.

Sujet--domainPremière sourceSi elle échoue
IA / ML / NLP / vision / robotique / informatiquemlarXivSemantic Scholar, puis OpenAlex
Physique / astronomiephysarXivSemantic Scholar, puis OpenAlex
MathématiquesmatharXivSemantic Scholar, puis OpenAlex
Biologie / médecine / génétique / pharmabioEurope PMCSemantic Scholar, puis OpenAlex
Psychologie / sciences cognitivespsyEurope PMCSemantic Scholar, puis OpenAlex
Chimie / matériauxchemSemantic ScholarOpenAlex
Mixte ou flouautoSemantic ScholarOpenAlex
  • État de l'art ou « le plus cité » : --sort citations. arXiv n'a pas de décompte de citations, donc ce tri commence à Semantic Scholar.
  • Ce qui est nouveau : --sort date ou --year 2023-.
  • Un article nommé par son titre : cherchez ce titre en anglais. Avec --sort relevance, un titre identique est classé premier.

Triage

Lancez la recherche avec --abstract. Ne conservez que les articles que vous utiliserez.

  • fondamental : très cité et âgé de plus de deux ans.
  • récent : des deux dernières années et sur le sujet, même avec peu de citations.
  • marginal : à côté du sujet. Laissez-le hors de la note.

Lecture

  1. Le résumé suffit, sauf si l'utilisateur a demandé une méthode, un nombre ou une citation exacte.
  2. Ouvrez le PDF alors seulement : read URL --pages 1-3. Pour la fin, lisez les 2 à 4 dernières pages. Si vous ne connaissez pas la longueur, restez sur 1-3. Ne devinez pas les numéros de page.
  3. ERROR: not a PDF ou pdf=(no open PDF…) : exécutez oa <DOI> et lisez le pdf= qu'il affiche. Si pdf=-, il n'y a pas de PDF direct légal. Gardez le résumé. Ne traitez pas l'url= de la page d'atterrissage comme l'article.
  4. Ces hôtes peuvent être lus directement : arxiv.org, europepmc.org, ncbi.nlm.nih.gov et un dépôt universitaire. Tout autre hôte passe d'abord par oa.
  5. N'utilisez pas Sci-Hub, Library Genesis ou d'autres miroirs de bibliothèques obscures.

Lisez au maximum trois PDF par exécution. Si la question en nécessite davantage, finissez à partir des résumés et listez ceux que vous n'avez pas ouverts.

Note

# <question>

## Résultats
- Affirmation, seulement si le résumé ou les pages nommées le disent. (Vaswani et al. 2017, 10.48550/arXiv.1706.03762, résumé)

## Articles
- **Attention Is All You Need** (2017) — 120404 citations, OpenAlex
  - doi : 10.48550/arXiv.1706.03762
  - pdf : https://arxiv.org/pdf/1706.03762
  - lecture : résumé uniquement
  - pourquoi il est ici : une ligne tirée de ce texte

## Non lus
- Articles écartés comme hors sujet, ou PDF qui n'ont pas été ouverts.

Dans le chat, pointez vers le fichier. Ne le recopiez pas. Même règle de citation pour une réponse ne contenant qu'un article qui ne devient jamais un fichier : auteur, année, DOI et si cela provient du résumé ou de quelles pages.

Skills associés