agentcite

本地服务

agentcite-api.vercel.app搜索与检索018 周前更新

代码仓库访问官网

关于 agentcite

agentcite 是面向 AI 内容和 Agent 的 DOI 引用 API，使用 OpenAlex 记录返回可解析 DOI 的真实文献。它不会编造来源；MCP 服务仍在路线图中。

主要功能

01按主题检索文献
02返回 DOI 与解析链接
03提供作者、年份和期刊信息
04返回引用次数与 OpenAlex 标识
05生成 Markdown 引用结果

适用场景

01为 AI 生成内容补充文献引用
02按主题查找可核验的学术来源

MCP 相关

README 将 MCP 服务列为后续计划，目前没有说明可用的 MCP 接口。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "kevinx702-agentcite": {
      "command": "npx",
      "args": [
        "-y",
        "agentcite-mcp"
      ]
    }
  }
}

启动命令npx -y agentcite-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmagentcite-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
n	integer	否	引用数量（默认 5）
since	integer	否	最早出版年份，例如 2015
topic	string	是	要查找引文的主题，例如 "red light therapy hair growth"

详细介绍

AgentCite

为 AI 内容和智能体提供杜绝伪造、由 DOI 支持的引文。每条结果都是真实的 openAlex 记录（CC0 公共领域数据），且带有可解析的 DOI — API 绝不会伪造来源。旨在解决虚构引文问题，避免内容因 E-E-A-T 不达标而降权。

与 giftedpicks.com 分开部署（独立的 Vercel 项目）。将 GiftedPicks/scripts/citation_magnet.py 的逻辑产品化。

API（MVP）

GET /api/cite?topic=<q>&n=5&since=YYYY → { topic, count, works[], markdown, source }
- 每条作品：{ title, authors[], first_author, year, doi, doi_url, cited_by_count, venue, openalex_id }
GET /api/health → { status, openalex, ts }

数据：openAlex REST（按相关性排序、经同行评审的 type:article）。设置 OPENALEX_MAILTO 环境变量以加入 openAlex 的礼貌池。每个主题的边缘缓存时长为 1 小时。

路线图（构建顺序）

✅ 核心 /cite + /health（openAlex REST，无密钥、无二进制文件 — 可移植到无服务器环境）
⏳ API 密钥 + 配额门控（Supabase：匿名免费层限速，密钥用户使用 Pro）
⏳ MCP 服务：get_citations(topic, n, since)（stdio + http）— 面向 Agent 的原生接口
⏳ Stripe 计费（先使用 TEST 模式；托管 Checkout/Payment Link → 通过 webhook 配置配额）。受限：需要 Kevin 保存 .claude/secrets/stripe-test-{publishable,secret}-key。正式上线 = Kevin 将正式密钥放入部署环境；Agent 永远不会持有该密钥。
落地页 + MCP 注册目录列表 — 由 Cowork 负责。

防护措施

仅使用公共领域数据（不进行抓取 / 不调用非官方站点 API）。诚信就是产品：输出始终会提示“请验证每个 DOI 均可解析。”在 Kevin 启用正式模式前，仅接受测试模式付款；Agent 永远不会转移资金或持有正式密钥。

计费（Stripe）

通过托管的 Stripe Checkout（订阅）提供 Pro 层级。在 checkout.session.completed 时，经签名验证的 webhook（/api/stripe-webhook）会在 Redis 中配置 Pro API 密钥（提升免费层→Pro 配额）。通过环境变量配置：

STRIPE_SECRET_KEY、STRIPE_PRICE_ID、STRIPE_WEBHOOK_SECRET、REDIS_URL
仅需创建一次 Pro 产品/价格：STRIPE_SECRET_KEY=sk_test_… node scripts/setup-stripe-product.js
未设置 Stripe 环境变量时，/api/checkout 会返回 503，引文 API 仍可按免费层运行。