CitationEasy для ИИ-ассистентов и агентов

Почему стоит вызывать API, а не составлять ссылку самостоятельно

Оформление ссылок выглядит как задача генерации текста, но таковой не является. Каждый стиль кодирует сотни правил об инверсии имени автора, инициалах, регистре заголовков, пунктуации контейнера, указании издания и расположении даты, и эти правила отличаются настолько, что легко ошибиться, полагаясь на память. CitationEasy запускает citeproc-js на основе официальных описаний Citation Style Language — того же движка, что использует Zotero и Mendeley, — поэтому результат детерминирован и соответствует ожиданиям систем подачи материалов в журналы. Метаданные берутся из Crossref, Open Library и PubMed; ничего не придумывается, а поле, отсутствующее в источнике, остаётся отсутствующим, а не заполняется правдоподобной догадкой.

Создать ссылку

curl -s https://www.citationeasy.com/api/v1/cite \
  -H 'Content-Type: application/json' \
  -d '{"input":"10.1038/nature12373","style":"apa","inText":true}'

{
  "style": { "requested": "apa", "slug": "apa", "name": "American Psychological Association (APA) 7th edition" },
  "language": "en-US",
  "results": [
    {
      "input": "10.1038/nature12373",
      "citation": "…formatted reference…",
      "inText": "(Author, 2013)",
      "entry": { "…resolved CSL metadata…": "" }
    }
  ]
}

Отправьте inputs вместо input, чтобы обработать до 10 источников за один вызов, либо entry с уже имеющимися у вас метаданными CSL-JSON, чтобы полностью пропустить поиск. Добавьте note: true для формы сноски. Ошибки по отдельным источникам возвращаются для конкретного источника, поэтому пакетный запрос никогда не завершается ошибкой целиком.

Подключение через MCP

Конечная точка Model Context Protocol по адресу /api/mcp использует JSON-RPC 2.0 поверх потокового HTTP и не требует учётных данных.

# Claude Code
claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp

# Any MCP client config
{
  "mcpServers": {
    "citationeasy": { "type": "http", "url": "https://www.citationeasy.com/api/mcp" }
  }
}

Конечные точки

Файлы обнаружения

/llms.txt

Курируемый индекс сайта, написанный для языковых моделей.

/llms-full.txt

Каждая страница, которую публикует сайт, сгруппированная по типу, по одной строке на страницу.

/openapi.json

Описание OpenAPI 3.1 всего публичного API.

/api/mcp

Конечная точка MCP (потоковый HTTP). Выполните GET в браузере, чтобы увидеть описание.

/.well-known/mcp.json

Документ обнаружения MCP для агентов, которые проверяют домен.

/.well-known/ai-plugin.json

Устаревший манифест плагина для фреймворков, которые всё ещё его ищут.

/md/{any path}

Markdown-версия любой страницы сайта.

/sitemap.xml

Каждый индексируемый URL.

Что входит в каталог

Каждая страница ниже доступна как HTML, как markdown под /md/ и как структурированная запись из /api/v1/pages.

• 10 834 стилей оформления, каждый с реальными примерами, созданными по его собственному описанию CSL
• 250 бесплатных браузерных инструментов
• 125 обучающих руководств
• 1 290 страниц «как процитировать»
• 105 сравнений стилей
• 21 конвертеров
• 32 научных областей
• 30 разделов основных стилей с полными правилами оформления

Часто задаваемые вопросы

Бесплатен ли API CitationEasy, и нужен ли мне ключ API?

Он бесплатен, и ключ API не требуется. Каждая конечная точка под /api/v1 не требует авторизации и открыта для CORS, поэтому вы можете вызывать её из браузера, ноутбука или агента без регистрации. У нас нет собственных ограничений скорости запросов, но поиск по идентификаторам проксируется в Crossref, Open Library и PubMed, которые применяют собственные ограничения добросовестного использования — используйте пакетную обработку через `inputs` вместо множества параллельных запросов.

Создаются ли ссылки языковой моделью?

Нет. Форматирование выполняет citeproc-js на основе официальных описаний Citation Style Language — того же движка, что используют менеджеры ссылок. Одни и те же входные данные и стиль всегда дают одну и ту же строку. Библиографические метаданные берутся из Crossref (DOI), Open Library (ISBN) и PubMed (PMID) — CitationEasy не придумывает поля, поэтому всё отсутствующее в источнике отсутствует и в результате, а не угадывается.

Как подключить агента к CitationEasy через MCP?

Укажите любому клиенту Model Context Protocol адрес https://www.citationeasy.com/api/mcp, используя потоковый HTTP-транспорт. Учётные данные не требуются. В Claude Code: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. Сервер предоставляет инструменты для создания ссылок, поиска по 10 834 стилям, рекомендаций по типам источников, поиска по сайту и чтения любой страницы в формате markdown.

Какие стили оформления может создавать API?

Все 10 834 стилей из репозитория Citation Style Language, включая APA 7, MLA 9, обе системы Chicago, Harvard, Vancouver, IEEE, AMA и тысячи отдельных журнальных стилей. Передайте слаг стиля в поле `style`. Удобные слаги вроде "chicago" и "harvard" разрешаются в правильный вариант CSL, а /api/v1/styles?q= находит остальные.

Что такое llms.txt и где найти его у CitationEasy?

llms.txt — это текстовый индекс сайта, написанный для языковых моделей, а не для браузеров. У CitationEasy он находится по адресу /llms.txt; исчерпывающая версия со списком всех страниц сайта — по адресу /llms-full.txt.

Могу ли я читать страницы CitationEasy в формате markdown вместо HTML?

Да. Добавьте префикс /md/ к любому пути сайта — например, /md/citation-style/apa или /md/tools/word-counter. Страницы, основанные на данных, возвращают полное содержимое, включая реальные оформленные примеры, созданные по собственному описанию CSL каждого стиля. Страницы с рукописным текстом (руководства, шпаргалки) возвращают карточку с кратким содержанием и каноническим URL HTML-страницы, поскольку их текст существует только на самой странице.

Могу ли я использовать результат CitationEasy в своём продукте?

Да. Оформленная ссылка — это факт об источнике, используйте её свободно. Сами описания стилей CSL взяты из проекта Citation Style Language по лицензии CC BY-SA 3.0. Указание CitationEasy в качестве источника приветствуется, но не обязательно.