会伴 API 与 MCP 服务

以程序化、只读的方式访问会伴的全量数据：5,800 个学术会议与 1,213 份期刊，涵盖征稿启事与投稿截止日期、会议日期与地点、并排呈现的 CCF / ICORE / QUALIS 分级、历年录用率、换届历史、期刊影响因子、ISSN 与特刊。同一份数据提供两种接入方式：REST API，以及面向 AI 智能体的原生 MCP 服务。

搜索、榜单列表与统计接口完全无需注册。 直接调用即可 —— 匿名客户端可用每天 50 次请求（按来源 IP 计数）。只有单条会议 / 期刊的详情接口需要免费账号。

现在就试

以下三条命令可以直接复制运行，无需任何凭证与账号：

# AI 方向、未来三个月内截稿的会议
# （不需要关键词 —— 所有搜索参数都是可选的，可任意组合）
curl "https://www.myhuiban.com/api/conferences?field=ai&submission_date_start=2026-08-01&submission_date_end=2026-11-01"

# 当前正在征稿的会议
curl "https://www.myhuiban.com/api/conferences/rankings/cfp?per_page=5"

# 全站统计（总数、按月截稿分布、榜单等级、研究领域、国家分布）
curl "https://www.myhuiban.com/api/statistics"

每个响应都带 X-Quota-Limit 与 X-Quota-Remaining，可随时查看当日剩余额度。CORS 已开放，因此这些请求在浏览器 JavaScript 里同样可用。

REST 端点

端点	返回什么	凭证
`GET /api/conferences`	搜索。所有参数均可选，可任意组合：`query`, `ccf_rank`, `core_rank`, `qualis_rank`, `field` (21 个研究领域), `submission_date_start`, `submission_date_end`, `conference_date_start`, `conference_date_end`, `updated_since` (增量同步)。	无需
`GET /api/conferences/rankings/{ranking}`	精选榜单：`cfp`, `past_cfp`, `ccf`, `core`, `qualis`, `most_viewed`, `most_tracked`, `most_attended`, `most_competitive`, `upcoming`, `past`, `trending`。	无需
`GET /api/journals`	搜索。所有参数均可选：`query`, `ccf_rank`, `issn`, `field`, `updated_since`。	无需
`GET /api/journals/rankings/{ranking}`	精选榜单：`cfp`, `ccf`, `highest_if`, `most_viewed`, `most_tracked`, `all`。	无需
`GET /api/statistics`	总数、未来按月截稿分布、进行中征稿的榜单等级分布，以及国家 / 研究领域 / 影响因子 / 出版方分布。	无需
`GET /api/conferences/{id}`	完整详情：征稿全文、历年录用率、换届历史、评分、评论、相关会议 / 期刊。	需账号
`GET /api/journals/{id}`	完整详情：征稿全文、特刊、评分、评论、相关期刊 / 会议。	需账号
`GET /api/researchers/{id}`	研究者的公开档案：所属机构、系统自动生成的研究兴趣画像、简历、跟踪 / 参加过的会议与期刊。绝不含联系方式；只能按 id 获取 —— 不提供研究者检索与枚举。	需账号
`POST /api/login`	用账号凭证换取 JWT。	无需

任何列表都可用 page 与 per_page 分页（每页最多 100 条）。完整的机器可读契约见 OpenAPI 3 描述。

MCP 服务（面向 AI 智能体）

原生 Model Context Protocol 服务以 Streamable HTTP 方式运行在 POST https://www.myhuiban.com/mcp，并已在官方 MCP registry 中登记为 com.myhuiban.www/conference-partner。可以把它加进任意 MCP 客户端，例如：

claude mcp add --transport http huiban https://www.myhuiban.com/mcp

共八个工具：search_conferences, search_journals, list_conferences, list_journals, get_conference, get_journal, get_researcher, get_statistics。搜索类工具接受与 REST 搜索端点完全相同的可选筛选条件（21 个领域的研究方向、各类分级，以及投稿 / 会议日期区间）。

以下工具无需任何凭证即可调用：search_conferences, search_journals, list_conferences, list_journals, get_statistics。三个详情类工具（get_conference, get_journal, get_researcher）需要凭证 —— 见下文。

本服务还提供 MCP prompts（提示词）—— 客户端会把它们做成一点即用的起手式，省得你面对一串工具名去想该问什么：upcoming_deadlines, where_to_submit, venue_snapshot, open_special_issues。每条展开后都会点名该调哪些工具，也都支持可选参数，比如研究领域或往后看多少天。

每个 MCP 工具都有对应的 REST 端点（如 get_researcher ↔ GET /api/researchers/{id}）：两条通道跑的是同一套查询层、返回完全一致的负载，因此更换传输方式不需要改动任何解析逻辑。

为详情接口获取凭证

在 myhuiban.com/registration 注册免费账号，并完成邮箱验证。
在 myhuiban.com/account/api-keys 生成一把 API 密钥。密钥只显示一次 —— 我们只保存它的哈希值。

在每个请求上带上它：Authorization: Bearer <credential>

curl -H "Authorization: Bearer hb_..." \
  https://www.myhuiban.com/api/conferences/1

接入 MCP 客户端也是这么做。Claude、ChatGPT、Cursor 与 VS Code 都支持「填一个远程 MCP 服务器地址（https://www.myhuiban.com/mcp）+ 一个固定请求头」，API 密钥正好是这种形态，无需再跑一轮换 token 的流程。

API 密钥永不过期，可在同一页面上逐把吊销；每把单独计量，因此可以给每个客户端各配一把。如果你更希望在运行时用账号密码换凭证，POST /api/login 仍会返回一个有效期约六个月的 JWT —— 它能用在密钥能用的所有地方，但无法单独吊销。

同一账号下的每一把凭证共用同一份额度（每天 200 次请求），REST API 与 MCP 服务合计。

有三样东西不能自助开通，但可以申请：更高的额度、每个会议 / 期刊自己的官网地址（响应默认只给 detail_page），以及整份数据集的批量导出。把你在做的东西发邮件到 [email protected]，我们会告诉你能怎么配合 —— 没有公开价目表，因为到目前为止每一份需求都不一样。

保持本地副本同步

先不带 updated_since 全量拉一次，之后每次把 updated_since 设成你见过的最新 updated_at 再轮询，就只会回该日期（含）之后有改动的条目。

curl 'https://www.myhuiban.com/api/conferences?updated_since=2026-08-01&per_page=100'

两点需要知道：粒度是天，所以把最新那一天重取一遍是正常且幂等的；另外从未被编辑过的条目没有变更记录，它们只出现在全量拉取里，不会进增量流。

配额与状态码

200 — 成功。查看 X-Quota-Remaining 可知当日剩余额度。
401 — 该端点需要凭证（只有单条会议 / 期刊的详情端点需要），或者你带的凭证无效 / 已吊销 / 已过期。想用匿名层就完全不要带 Authorization 头 —— 不可用的凭证绝不会被静默降级到匿名层。
402 — 你的账号当日额度已用尽。Retry-After 会告诉你距离重置还有多少秒。
429 — 按 IP 计的匿名当日额度已用尽；申请一把免费 API 密钥可大幅提额。Retry-After 会告诉你距离重置还有多少秒 —— 请等满这段时间再重试，不要提前反复重试；定时任务请用 updated_since，只取有变化的部分。

客户端示例与可下载快照

github.com/sundou82/conference-partner-mcp 是配套的公开仓库：可直接粘贴的 Claude / Cursor / VS Code 的 MCP 配置、无需 API 密钥即可运行的 Python / Node / curl 客户端，以及每天从本站重新抓取的 OpenAPI 文档。MCP 服务与 API 本身是托管服务、并非开源 —— 使用它们不需要安装仓库里的任何东西。

仓库里还有每日重建的数据快照，JSON 与 CSV 两种格式：临近截稿、CCF 与 CORE 目录、CCF 期刊、开放中的特刊征稿，以及按影响因子排序的期刊。范围正好是上面那些无需凭证的端点所提供的内容 —— 单条会议 / 期刊的详情仍留在 API 之后。截稿日期一变文件就过期了，所以它适合浏览与批量装载；要准确请调用 API。

使用条款

本 API 只读且免费使用，商业产品同样可用，条件是注明来源「会伴」并链接回本站对应的会议 / 期刊页面 —— 每个响应都带一个 detail_page 地址正是为此准备的。批量抓取列表时请保持每秒不超过一次请求。需要整体再分发数据集时，请直接用我们发布的数据快照，不要自己爬；范围更广的用途请先与我们联系，数据集授权与模型训练尤其如此。分级与数据的来源另见方法论。

其它机器可读入口

/api/openapi.json — OpenAPI 3 描述
/llms.txt — 面向 LLM 的站点自述
/llms-full.txt — 面向 LLM 的站点自述，并附实时数据样本
/.well-known/api-catalog — RFC 9727 API 目录
/auth.md — 认证说明
会议 / 期刊详情页的精简 Markdown 表示 —— 请求头带 Accept: text/markdown（且不含 text/html）即可。
未来截稿日期的 RSS 订阅源与 iCalendar 订阅源
github.com/sundou82/conference-partner-mcp —— 客户端示例、MCP 配置文件与每日数据快照

有疑问、发现问题，或希望我们支持某个使用场景，请联系 [email protected]。

开发者 API