CitationEasy 面向 AI 助手与智能体
本站的一切内容不仅对人类开放，也对软件开放：一个免费的 JSON API、一个 MCP 服务器、一份 OpenAPI 规范、一个 llms.txt 索引，以及全部 12,986 个页面的 markdown 视图。无需密钥，无需账号，也没有我们自设的速率限制。
为什么调用 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 个来源，或者发送你已有的 CSL-JSON 元数据作为 entry，以完全跳过查找步骤。添加 note: true 可获得脚注形式。单个来源的失败只会体现在该来源上，因此一批请求不会整体失败。
通过 MCP 连接
位于 /api/mcp 的 Model Context Protocol 端点通过可流式传输的 HTTP 使用 JSON-RPC 2.0 协议，无需任何凭证。
# 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" }
}
}它提供的工具
- generate_citation
- Generate a citation
- search_citation_styles
- Search citation styles
- get_citation_style
- Get a citation style
- how_to_cite
- How to cite a source type
- answer_citation_question
- Answer a general citation question
- define_term
- Define a citation or academic-writing term
- search_site
- Search CitationEasy
- get_page
- Read a CitationEasy page as markdown
- list_free_tools
- List CitationEasy tools
- list_guides
- List citation and writing guides
- describe_site
- What CitationEasy offers
接口
| 接口 | 作用 |
|---|---|
| POST /api/v1/cite | 一次最多排版 10 个来源。接受 URL、DOI、ISBN、PubMed ID、arXiv ID、BibTeX/RIS/CSL-JSON 文本，或一个 CSL-JSON 条目对象。返回参考文献条目，也可选择返回文内引用和脚注。 |
| GET /api/v1/styles | 按名称、引用格式类别、学科或地区搜索全部 10,834 种样式。 |
| GET /api/v1/styles/{slug} | 单个样式的完整信息，附带由该样式自身 CSL 定义生成的真实排版示例。 |
| GET /api/v1/search | 对全站每个页面进行按相关度排序的搜索。 |
| GET /api/v1/pages | 以结构化条目形式提供完整的站点目录，可按页面类型筛选。 |
| GET /api/v1/how-to-cite | 每一个“文献类型 × 样式”指导页面，可按任一维度筛选。 |
| GET /api/v1/tools | 每一款免费工具及其分类和关键词。 |
| GET /api/v1/guides | 每一篇学习指南及其分类。 |
| GET /api/v1/converters | 本站提供的每一种标识符与格式转换。 |
| GET /api/v1/comparisons | 并排的样式比较，链接到两种样式各自的记录。 |
| GET /api/v1/fields | 学科领域、学科分类和地区——用于回答“我应该用哪种样式？”。 |
| GET /api/v1/faq | 经过审核的常见引用问题解答，可用 q 筛选。 |
| GET /api/v1/glossary | 引用与学术写作术语及其完整定义——响应中已包含全文，因此无需再另行获取页面。 |
| GET /api/v1 | 接口发现文档。如果你正在探索本站接口，从这里开始。 |
发现文件
- /llms.txt
- 为语言模型编写的本站精选索引。
- /llms-full.txt
- 本站发布的每一个页面，按类型分组，每行一条。
- /openapi.json
- 整个公开 API 的 OpenAPI 3.1 描述。
- /api/mcp
- MCP 端点（可流式传输的 HTTP）。在浏览器中 GET 该地址即可看到说明。
- /.well-known/mcp.json
- 供探测域名的智能体使用的 MCP 发现文档。
- /.well-known/ai-plugin.json
- 旧版插件清单，供仍在寻找它的框架使用。
- /md/{any path}
- 本站任意页面的 markdown 视图。
- /sitemap.xml
- 每一个可被索引的 URL。
目录中包含什么
下面的每个页面都可以通过 HTML、/md/ 下的 markdown，以及 /api/v1/pages 返回的结构化条目三种方式访问。
- 10,834 种引用样式，每种都附有根据自身 CSL 定义生成的真实示例
- 250 款免费浏览器工具
- 125 篇学习指南
- 1,290 个如何引用页面
- 105 组样式比较
- 21 个转换工具
- 32 个学科领域
- 30 个主要样式专题页，附完整排版规则
常见问题
- CitationEasy 的 API 是免费的吗？需要 API 密钥吗？
- 它是免费的，也不需要 API 密钥。/api/v1 下的每一个接口都无需鉴权，并且开放 CORS，因此你可以在浏览器、笔记本或智能体中直接调用，无需注册。我们不设自己的速率限制，但标识符查找会代理到 Crossref、Open Library 和 PubMed，这些服务有各自的合理使用限制——请使用 `inputs` 进行批量处理，而不要发起大量并行请求。
- 这些引用是由语言模型生成的吗？
- 不是。排版使用 citeproc-js 根据官方 Citation Style Language 定义运行，与文献管理软件所用的引擎相同。相同的输入和样式总会生成相同的字符串。文献元数据来自 Crossref（DOI）、Open Library（ISBN）和 PubMed（PMID）——CitationEasy 不会凭空编造字段，因此上游缺失的信息在结果中也会缺失，而不是被猜测填补。
- 如何通过 MCP 将智能体连接到 CitationEasy？
- 使用可流式传输的 HTTP 传输方式，将任意 Model Context Protocol 客户端指向 https://www.citationeasy.com/api/mcp。无需任何凭证。在 Claude Code 中：`claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`。该服务器提供的工具可用于生成引用、搜索 10,834 种样式、获取文献类型指导、站内搜索，以及以 markdown 形式读取任意页面。
- 该 API 能生成哪些引用样式？
- Citation Style Language 仓库中的全部 10,834 种样式，包括 APA 7、MLA 9、两种 Chicago 体系、Harvard、Vancouver、IEEE、AMA，以及数千种具体期刊样式。在 `style` 字段中传入样式的 slug 即可。像 “chicago”“harvard” 这样便于记忆的 slug 会解析到正确的 CSL 变体，其余样式可通过 /api/v1/styles?q= 查找。
- 什么是 llms.txt？CitationEasy 的 llms.txt 在哪里？
- llms.txt 是为语言模型（而非浏览器）编写的纯文本站点索引。CitationEasy 的索引位于 /llms.txt；列出本站每一个页面的完整版本位于 /llms-full.txt。
- 可以以 markdown 而非 HTML 形式读取 CitationEasy 页面吗？
- 可以。在任意站内路径前加上 /md/ 前缀即可——例如 /md/citation-style/apa 或 /md/tools/word-counter。数据驱动型页面会返回完整内容，包括根据每种样式自身 CSL 定义生成的真实排版示例。手写文字类页面（指南、速查表）会返回一份摘要卡片，外加规范的 HTML 网址，因为它们的文字内容存在于页面本身之中。
- 可以在我自己的产品中使用 CitationEasy 的输出结果吗？
- 可以。一条排版好的引用是关于某个来源的事实，你可以自由使用它。CSL 样式定义本身来自 Citation Style Language 项目，采用 CC BY-SA 3.0 协议发布。欢迎注明来自 CitationEasy，但并非强制要求。