AIアシスタント・エージェント向けCitationEasy
このサイトのすべては、人だけでなくソフトウェアからも利用できます。無料の JSON API、MCP サーバー、OpenAPI 仕様、llms.txt インデックス、そして全 12,986 ページの Markdown ビューを提供しています。キーもアカウントも不要で、当サイト独自のレート制限もありません。
引用を自分で書かず API を呼ぶべき理由
引用の書式整形は、一見テキスト生成の問題のように見えますが、実際は違います。それぞれのスタイルには、著者名の反転・イニシャル表記・タイトルケース・コンテナの句読点・版表記・日付の位置など、数百ものルールが定められており、しかもスタイルごとに微妙に異なるため、記憶を頼りに書くと簡単に間違えてしまいます。CitationEasy は、公式の Citation Style Language 定義に対して citeproc-js を実行します。これは 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…": "" }
}
]
}1 回の呼び出しで最大 10 件の資料を処理するには、input の代わりに inputs を送信してください。すでに 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} | 1 つのスタイルの詳細を、その 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
- サイトが公開するすべてのページを、タイプ別に1行ずつまとめたものです。
- /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 に接続するにはどうすればよいですか?
- 任意の Model Context Protocol クライアントで、ストリーム対応 HTTP トランスポートを使い 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・シカゴの両方式・ハーバード・バンクーバー・IEEE・AMA、そして数千の個別学術誌スタイルも含まれます。`style` フィールドにスタイルのスラッグを指定してください。「chicago」や「harvard」のようなわかりやすいスラッグは正しい CSL バリアントに解決され、それ以外は /api/v1/styles?q= で検索できます。
- llms.txt とは何ですか?CitationEasy のものはどこにありますか?
- llms.txt は、ブラウザーではなく言語モデル向けに書かれた、サイトのプレーンテキストインデックスです。CitationEasy のものは /llms.txt にあり、サイトのすべてのページを網羅した完全版は /llms-full.txt にあります。
- CitationEasy のページを HTML ではなく Markdown として読めますか?
- はい。サイト内のどのパスにも /md/ を前に付けてください。例えば /md/citation-style/apa や /md/tools/word-counter です。データ駆動型のページは、各スタイル自身の CSL 定義から生成された実際の整形例を含む、全内容を返します。手書きの文章ページ(ガイドやチートシートなど)は、本文がページ自体にあるため、要約カードと正規の HTML の URL を返します。
- CitationEasy の出力を自分の製品で使ってもよいですか?
- はい。整形された引用は資料に関する事実であり、自由にお使いいただけます。CSL のスタイル定義自体は、Citation Style Language プロジェクトが CC BY-SA 3.0 のもとで提供しています。CitationEasy へのクレジット表記は歓迎しますが、必須ではありません。
何か足りないものはありますか?
エージェントに必要なエンドポイント・フィールド・形式がここにない場合は、お知らせください。手動で閲覧される場合は、引用ジェネレーターから始めてください。