ieee-search-mcp

ieee-search-mcp

当用户需要通过学校图书馆访问（代理/SSO 会话）搜索 IEEE Xplore，而不是直接访问 IEEE 公共入口时，使用此技能。

前提条件

• 已安装并可使用 Browser MCP（例如 chrome-devtools 或同类工具）。
• Agent 有权限控制浏览器。
• 如果缺少任一条件，请停止，并明确说明无法在浏览器中执行此工作流。
• 对于相对时间筛选（例如“近 2 年”），请先使用本地时间/日期工具，并在筛选前计算明确的年份范围。

学校配置（可插拔）

1. 从 assets/school_profiles.example.json 加载学校配置。
2. 如果用户未提供学校，请先询问用户。
3. 以下字段可按学校插拔配置：
   • library_home
   • proxy_ieee_home
   • db_keyword_candidates
   • 可选：known_database_detail_url
   • 可选：known_journals — 一个 alias -> {name, punumber, proxy_url} 的映射，供用户经常访问的期刊使用
4. 演示/默认配置为 wust（武汉科技大学）。

常见用户意图路径

路径 A：登录 + 关键词搜索 + 近期年份

1. 打开 library_home，确认登录状态。
2. 如果需要登录，请用户完成 SSO/二维码验证并等待。
3. 按顺序使用 db_keyword_candidates 搜索数据库（对于 WUST，如有需要，先尝试 IEL，再尝试 IEEE）。
4. 从图书馆入口进入 IEEE，并确认机构会话。
5. 执行关键词搜索。
6. 应用明确的年份范围（例如，如果当前年份是 2026 年，“近 2 年”表示 2025-2026 年）。
7. 按用户要求的格式返回结果。

路径 B：从现有代理 IEEE 页面继续

1. 如果用户提供或已打开代理 URL（例如 metaersp-2.../ieeexplore/...），请在同一页面/会话中继续。
2. 除非用户确认采用备用方案，否则不要直接打开 https://ieeexplore.ieee.org/。
3. 搜索前重新确认 Access provided by: 或代理主机。

路径 C：高级搜索/期刊搜索

1. 与用户确认模式（keyword / advanced / journal）。
2. 询问缺失的限制条件（查询字段、期刊名称、年份、文档类型）。
3. 执行搜索并返回结构化结果。

路径 D：已知期刊/直接导航（快速路径）

当用户提到期刊别名或全名，且配置中包含对应的 known_journals 条目时：

1. 将用户输入与 known_journals 键（不区分大小写）或 name 字段匹配。
2. 如果匹配，直接导航至缓存的 proxy_url — 完全跳过路径 A 的搜索流程。
3. 确认机构会话（Access provided by: 或 URL 中的代理主机）。
4. 如果会话已过期，转到路径 A 重新认证，然后返回缓存的 URL。
5. 到达期刊页面后，继续执行用户要求的操作（浏览近期内容、在期刊内搜索等）。

学习新的期刊快捷方式

当用户导航至尚未加入 known_journals 的期刊时：

1. 成功导航后，记录 punumber 和构造的代理 URL。
2. 提醒用户：“我已将此期刊记录为已知快捷方式 — 下次只要提到期刊名称，我就会直接前往。”
3. Agent 应建议在学校配置中将其添加到 known_journals。如果用户确认，请相应更新 assets/school_profiles.example.json。

真实 WUST 流程中的故障处理分支

• 数据库别名不匹配：搜索 IEEE 可能失败，请重试 IEL。
• 点击数据库行超时：刷新快照并重试一次。
• 仍无法点击：如果配置中有 known_database_detail_url，则导航至已知详情 URL。
• 会话偏离：如果跳转到了公共 ieeexplore.ieee.org，请立即通过 proxy_ieee_home 恢复代理路径。
• 页面/工具参数错误：重试前重新检查工具参数的类型/名称（例如，pageId 必须是数字）。

必须向用户确认的事项

在以下情况下，请询问用户，不要自行猜测：

• 尚未确认学校或图书馆配置文件。
• 登录步骤需要人工操作（验证码/二维码/2FA）。
• 出现多个几乎相同的数据库条目，无法明确点击目标。
• 用户提出相互冲突的限制（例如“仅使用代理会话”和“跳转到公开网站”）。
• 用户未指定输出格式，但要求“整理成表格/导出”。

可选的 CCF 后置筛选（使用 ccf-rank 技能）

如果用户提出“只要 CCF-A/CCF-B”或类似要求：

1. 从 IEEE 结果中收集会议/期刊信息。
2. 使用同级技能脚本： node ../ccf-rank/scripts/query_ccf_rank.mjs "<venue or journal>" --top 3
3. 仅保留符合指定等级的行（例如 A）。
4. 在输出中同时包含 IEEE 字段和 CCF 字段（type、rank、area）。

输出规则

• 优先遵循用户指定的格式。
• 如果用户要求表格，请使用包含所需列的 Markdown 表格。
• 如果用户未指定列，则默认使用以下列： title | year | venue/journal | authors | access_path | ieee_url | ccf_rank(optional)。
• 始终包含 access_path，以便用户确认使用了代理路径。
• 对于基于时间的筛选，请在回复文本中注明明确的年份范围。

最简运行摘要

每次运行都需报告以下 5 项：

1. 使用的访问路径（library_home -> db alias -> IEEE proxy page）。
2. 是否保留了机构访问权限。
3. 查询模式 + 查询内容 + 筛选条件。
4. 结果列表（或表格）。
5. 下一步操作选项（高级搜索/期刊搜索/CCF 筛选/打开全文）。