paper-search — скилл для Claude Code: что делает и как установить
Находит научные статьи через OpenAlex по ключевым словам, DOI или идентификатору. Ключ API не требуется, а база содержит свыше 250 млн публикаций.
npx skills add ykdojo/paper-search --skill paper-search -a claude-codeЧто делает paper-search
Скилл ищет научные публикации в открытой базе OpenAlex и выгружает метаданные: авторов, количество цитирований, аннотации, концепции и прямые ссылки на открытые PDF. Для работы используются два bash-скрипта: search.sh и paper.sh.
Поиск по запросу через search.sh поддерживает лимит выдачи до 200 записей, пагинацию и сортировку по релевантности, дате или числу цитирований. Если у статьи в результатах поиска нет аннотации, скрипт paper.sh по полному DOI или OpenAlex ID подтягивает текст описания и список related_works для анализа графа цитирования.
Для отправки запросов не нужен аккаунт или платный ключ, потому что OpenAlex предоставляет доступ свободно. Скрипты запускаются напрямую через bash в среде агента.
Какие задачи решает
- найти научные публикации по теме с сортировкой по цитированиям
- получить прямую ссылку на открытый PDF статьи по DOI
- извлечь аннотацию и список авторов по OpenAlex ID
- исследовать смежные работы через граф цитирования
Примеры запросов агенту
- Найди статьи про bilingual cognitive advantages с сортировкой по числу цитат
- Покажи аннотацию и ссылку на PDF для статьи по адресу https://doi.org/10.3390/brainsci8020020
- Проверь детали статьи с OpenAlex ID W2789811475 и покажи связанные публикации
Как установить paper-search
1Через Skills CLI (Vercel)
npx skills add ykdojo/paper-search --skill paper-search -a claude-code2Вручную: положить файлы
~/.claude/skills/paper-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/paper-search/
1Через Skills CLI (Vercel)
npx skills add ykdojo/paper-search --skill paper-search -a codex2Вручную: положить файлы
.agents/skills/paper-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ykdojo/paper-search --skill paper-search -a cursor2Вручную: положить файлы
.cursor/skills/paper-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ykdojo/paper-search paper-search2Вручную: положить файлы
.github/skills/paper-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add ykdojo/paper-search --skill paper-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/ykdojo/paper-search --path skills/paper-searchВручную: положить файлы
.devin/skills/paper-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ykdojo/paper-search --skill paper-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о paper-search
Как установить paper-search в Claude Code?
Выполните команду npx skills add ykdojo/paper-search --skill paper-search -a claude-code. Конфигурация запишется в ~/.claude/skills/paper-search/SKILL.md.
Что делает paper-search?
Он обращается к каталогу OpenAlex и возвращает научные статьи, авторов, ссылки на открытые PDF-файлы и количество цитирований.
Нужен ли API-ключ для работы paper-search?
Нет, OpenAlex работает бесплатно и не требует ключа API для выполнения поисковых запросов.
Исходный текст
SKILL.md · MIT
--- name: paper-search description: Search for academic papers by keyword, or look up a specific paper by DOI or OpenAlex ID. Powered by OpenAlex (250M+ works, free, no API key). --- Search for academic papers and get details including title, authors, citation count, DOI, abstract, and open access links. Steps: 1. Find the scripts directory: `find ~/.claude -name "search.sh" -path "*/paper-search/*" 2>/dev/null | sort -V | tail -1` - This finds the script whether installed via plugin or manual setup - The `paper.sh` script is in the same directory 2. To search for papers by keyword: ``` <scripts-dir>/search.sh "your search query" [limit] [sort] [page] ``` - `limit`: number of results per page (default: 10, max: 200) - `sort`: `relevance` (default), `cites`, or `date` - `page`: page number for pagination (default: 1) 3. To look up a specific paper by DOI or OpenAlex ID: ``` <scripts-dir>/paper.sh <DOI_URL or OpenAlex_ID> ``` - Accepts full DOI URLs like `https://doi.org/10.3390/brainsci8020020` - Or OpenAlex IDs like `W2789811475` - Returns full details: authors, abstract, concepts, open access PDF link, related works Tips: - Use `relevance` sort (default) for topical searches. Use `cites` when you want landmark papers. - Be specific with queries — "bilingual cognitive advantages executive function" beats "bilingualism brain". - Use `paper.sh` to get the full abstract when search results show "Abstract: N/A". - The `related_works` IDs from `paper.sh` can be fed back into `paper.sh` to explore the citation graph. - When the user asks for scientific backing: search broadly first, pick the most relevant/cited papers, then use `paper.sh` for full details and cite as (Author, Year, Journal).
© ykdojo · MIT · ykdojo/paper-search
