Исследования
asta-skill
Agents365-ai/asta-skillСкилл для Claude Code и других MCP-совместимых агентов: поиск статей, обход цитирований, поиск авторов и извлечение фрагментов из Semantic Scholar через сервер Ai2 Asta MCP. Не требует написания кода.
Установка
terminal
bash
claude mcp add -t http -s user asta https://asta-tools.allen.ai/mcp/v1 \README
asta-skill — Semantic Scholar через Ai2 Asta MCP 🔭
中文文档 | Обзор Asta MCP | Запросить API-ключ
Что умеет
- Поиск по академическому корпусу Semantic Scholar: по ключевым словам, названию, автору или фрагменту текста
- Поиск статьи по любому идентификатору (DOI, arXiv, PMID, PMCID, CorpusId, MAG, ACL, SHA, URL)
- Обход цитирований — кто цитировал статью, с фильтрацией и пагинацией
- Пакетный поиск нескольких статей за один вызов через
get_paper_batch - Поиск фрагментов — извлечение отрывков ~500 слов из тел статей для подтверждения фактов
- Поиск авторов — нахождение исследователей и списка их публикаций
- Интеграция без кода — скилл представляет собой набор инструкций; весь ввод/вывод проходит через сервер Asta MCP
- Активируется автоматически, когда пользователь запрашивает статьи, цитирования, академический поиск или обзор литературы, и инструменты Asta зарегистрированы
Поддержка платформ
Работает с любым агентом, поддерживающим MCP, и любым хостом, загружающим Agent Skills:
| Платформа | Статус | Детали |
|---|---|---|
| Claude Code | ✅ Полная поддержка | Нативный SKILL.md + регистрация через claude mcp add |
| Codex | ✅ Полная поддержка | Запись MCP в ~/.codex/config.toml |
| Cursor / Windsurf / Hermes | ✅ Полная поддержка | Стандартный блок JSON mcpServers |
| opencode | ✅ Полная поддержка | Нативные скиллы + MCP в ~/.config/opencode/opencode.json |
| OpenClaw/ClawHub | ✅ Полная поддержка | Пространство имён metadata.openclaw + конфиг MCP |
| pi-mono | ✅ Полная поддержка | Пространство имён metadata.pimo |
| SkillsMP | ✅ Индексирован | Настроены GitHub-теги |
Сравнение
vs. semanticscholar-skill (REST-версия)
| Возможность | semanticscholar-skill | asta-skill |
|---|---|---|
| Транспорт | Python + прямой REST (s2.py) | MCP (streamable HTTP) |
| Требования к хосту | Python + S2_API_KEY | Хост с поддержкой MCP |
| Переменная авторизации | S2_API_KEY | ASTA_API_KEY (через x-api-key) |
| Лучше подходит для | Скриптовых пакетных задач, кастомных фильтров | Интеграции агентов без кода |
| Работает в Cursor / Windsurf из коробки | ❌ | ✅ |
vs. агент без скилла
| Возможность | Нативный агент | Этот скилл |
|---|---|---|
Знает эндпоинт Asta и заголовок x-api-key | ❌ | ✅ |
| Таблица соответствия намерений и инструментов | ❌ | ✅ |
| Паттерны рабочих процессов (discovery / seed expansion / author / evidence) | ❌ | ✅ |
Предупреждает о раздувании контекста при fields=citations | ❌ | ✅ |
| Рецепты установки для каждого MCP-хоста | ❌ | ✅ |
Предварительные требования
-
Агент-хост с поддержкой MCP (Claude Code, Codex, Cursor, Windsurf, opencode, OpenClaw/ClawHub, pi-mono и др.)
-
API-ключ Asta — запросить здесь
export ASTA_API_KEY=xxxxxxxxxxxxxxxx
Регистрация MCP-сервера
Зарегистрируйте сервер Asta MCP в вашем хосте до установки скилла.
Claude Code
bash
claude mcp add -t http -s user asta https://asta-tools.allen.ai/mcp/v1 \
-H "x-api-key: $ASTA_API_KEY"После этого перезапустите Claude Code, чтобы MCP-инструменты загрузились при старте сессии.
Codex CLI
Отредактируйте ~/.codex/config.toml:
toml
[mcp_servers.asta]
type = "http"
url = "https://asta-tools.allen.ai/mcp/v1"
headers = { "x-api-key" = "${ASTA_API_KEY}" }Cursor / Windsurf / Hermes / другие MCP-клиенты
json
{
"mcpServers": {
"asta": {
"serverUrl": "https://asta-tools.allen.ai/mcp/v1",
"headers": { "x-api-key": "<YOUR_API_KEY>" }
}
}
}Установка скилла
Claude Code
bash
# Глобально (доступно во всех проектах)
git clone https://github.com/Agents365-ai/asta-skill.git ~/.claude/skills/asta-skill
# На уровне проекта
git clone https://github.com/Agents365-ai/asta-skill.git .claude/skills/asta-skillCodex
bash
git clone https://github.com/Agents365-ai/asta-skill.git ~/.codex/skills/asta-skillOpenClaw/ClawHub
bash
git clone https://github.com/Agents365-ai/asta-skill.git ~/.openclaw/skills/asta-skill
# На уровне проекта
git clone https://github.com/Agents365-ai/asta-skill.git skills/asta-skillpi-mono
bash
git clone https://github.com/Agents365-ai/asta-skill.git ~/.pimo/skills/asta-skillSkillsMP
skills install asta-skill
Сводная таблица путей установки
| Платформа | Глобальный путь | Путь проекта |
|---|---|---|
| Claude Code | ~/.claude/skills/asta-skill/ | .claude/skills/asta-skill/ |
| Codex | ~/.codex/skills/asta-skill/ | N/A |
| OpenClaw/ClawHub | ~/.openclaw/skills/asta-skill/ | skills/asta-skill/ |
| pi-mono | ~/.pimo/skills/asta-skill/ | — |
| SkillsMP | N/A (устанавливается через CLI) | N/A |
Использование
Просто опишите, что вам нужно:
> Use Asta to get the paper with DOI 10.48550/arXiv.1706.03762
> Search Asta for recent papers on mixture-of-experts at NeurIPS since 2023
> Who cited "Attention Is All You Need"? Show me the top 20 by citation count
> Find snippets in the Asta corpus that mention "flash attention latency"
> Look up Yann LeCun on Asta and list his 2024 papers
Скилл выбирает нужный инструмент Asta, подставляет безопасные значения fields и следует задокументированным паттернам рабочих процессов.
Доступные инструменты Asta
| Инструмент | Назначение |
|---|---|
get_paper | Поиск одной статьи по любому поддерживаемому идентификатору |
get_paper_batch | Пакетный поиск нескольких идентификаторов за один вызов |
search_papers_by_relevance | Широкий поиск по ключевым словам с фильтрами по площадке и дате |
search_paper_by_title | Поиск по названию |
get_citations | Постраничный обход цитирований |
search_authors_by_name | Поиск профиля автора |
get_author_papers | Все статьи указанного автора |
snippet_search | Отрывки ~500 слов из тел статей |
Файлы
SKILL.md— единственный обязательный файл. Загружается всеми хостами как инструкции скилла.README.md— этот файл (английская версия, отображается на главной странице GitHub)README_CN.md— китайская версия документации