citeguard

CiteGuard

AI が生成したテキストの主張ごとの引用検証です。 CiteGuard は引用されたソースをすべて取得し、実際にその主張を裏付けているかを、根拠となる引用箇所とともに示します。そのため、判定を数秒で自分で確認できます。

vibe citingの時代に向けて作られました。AI が作成したレポートには、実在する URL に解決されるものの、本文で述べられている内容を実際には書いていない引用があふれています。

できること

CiteGuard にドキュメント（Markdown またはプレーンテキスト）か、明示的な主張と URL の組み合わせを渡します。各主張について、次の処理を行います。

1. 引用されたソースを取得 — タイムアウト処理、リダイレクトの追跡、5 MB の上限を備え、リンク切れの場合は archive.org に自動的にフォールバックします。
2. ソースの有効性を確認 — リンク切れの URL、DOI のリダイレクト、「ソフト 404」（ホームページに転送されるリダイレクト）を明示的に指摘します。
3. 実際のコンテンツを抽出 — Readability を使って定型文を除いた記事本文を抽出します。PDF にも対応しています。
4. 含意関係を判定 — LLM は取得したソーステキストのみを読み（自身の世界知識は使用しません）、6 種類の判定のいずれかを返します。

判定	意味
supported	ソースに主張が明確に記載されているか、直接含意されています
partially_supported	主張の一部は含まれていますが、重要な要素が異なるか、欠けています
contradicted	ソースには反対の内容が記載されています
unsupported	ソースは実在しますが、主張は含まれていません
uncertain	ソースのテキストが断片的または曖昧すぎて判断できません
could_not_fetch	ソースに到達できず、アーカイブのスナップショットもありません — 推測はしません

すべての判定には、原文どおりの根拠となる引用、信頼度スコア、ソースの完全なステータスが付属します。ドキュメントの監査では、**引用の整合性スコア（0〜100）**も返されます。

CiteGuard は決して過剰な主張をしません。ソースを取得できない場合は、根拠なく判定するのではなく、その旨を伝えます。また、判断が難しいケースは uncertain となります。目的は人間による検証を 10 倍速くすることであり、検証を置き換えることではありません。

クイックスタート（MCP）

Claude Code／Claude Desktop／任意の MCP クライアントに追加します。

{
  "mcpServers": {
    "citeguard": {
      "command": "npx",
      "args": ["-y", "citeguard-mcp"],
      "env": {
        "CITEGUARD_JUDGE_PRESET": "qwen",
        "CITEGUARD_JUDGE_KEY": "sk-..."
      }
    }
  }
}

公開されるツール：verify_claims、check_document、check_links（有効性のみを確認するため、LLM キーは不要です）。

クイックスタート（CLI）

npm install -g citeguard

citeguard extract report.md   # show extracted claim/source pairs (no network)
citeguard links report.md     # dead-link check (no LLM needed)
citeguard check report.md     # full audit (needs judge configured)

判定設定

CiteGuard はモデルに依存しません。OpenAI 互換のチャットエンドポイントを備えたものなら何でも動作します。

# Preset providers
export CITEGUARD_JUDGE_PRESET=qwen        # or: openai, anthropic
export CITEGUARD_JUDGE_KEY=sk-...

# Or any OpenAI-compatible endpoint
export CITEGUARD_JUDGE_URL=https://your-endpoint/v1
export CITEGUARD_JUDGE_MODEL=your-model
export CITEGUARD_JUDGE_KEY=sk-...

ホステッド API

Cloudflare Workers 上で、無料のホステッドエンドポイント（IP あたり 1 日 50 リクエスト）を提供しています。

curl -X POST https://citeguard.YOUR-SUBDOMAIN.workers.dev/api/verify \
  -H "content-type: application/json" \
  -d '{"claims":[{"text":"The Eiffel Tower is 330 m tall.","source":"https://en.wikipedia.org/wiki/Eiffel_Tower"}]}'

リモート MCP エンドポイント：POST /mcp（ストリーミング可能な HTTP、ステートレス）。

CiteGuard が対象としないもの

• AI テキスト検出ツールではありません。 誰がテキストを書いたかは問いません。引用されたソースが主張を裏付けているかを確認します。
• 真実を判定するものではありません。 supported 判定が意味するのは引用されたソースにこのように書かれているということであり、これが真実であるということではありません。質の低いソースからは、質の低い裏付けしか得られません。
• 検索エンジンではありません。 手元にある引用を検証します。より良い引用は（まだ）探しません。

抽出形式

Markdown のインラインリンク、参照形式のリンク、脚注、単独の DOI（doi.org 経由で解決）、単独の URL に対応しています。APA 形式の解析と、入力ドキュメントとしての PDF 対応は今後のロードマップに含まれています。

開発

git clone https://github.com/Franksterino/citeguard
cd citeguard
npm install
npm run typecheck
npx tsx src/cli.ts extract test/fixtures/sample.md

ライセンス

MIT