内容
# 克劳德研究代理
> 多源研究代理，适用于 **克劳德代码**：一个MCP服务器（arXiv，OpenAlex，GitHub，黑客新闻，X/Grok）加上一个`/research`技能，可以扩展到子主题，并撰写结构化、富含引用的Markdown和干净可读的HTML报告。
适用于 [克劳德代码](https://claude.com/claude-code) 的插件，将其转变为研究代理：搜索科学数据库、代码和社交媒体，检查和汇总来源，生成**具有可点击引用的结构化报告**（Markdown + HTML）。
## 内部结构
- **MCP服务器** (`server/`)，包含五个工具来源：
| 工具 | 来源 | 密钥 |
|---|---|---|
| `search_arxiv` | 机器学习/人工智能预印本（arXiv） | — |
| `search_openalex` | 学术论文 + 引用（OpenAlex，跨学科） | — |
| `search_github` | 仓库/代码 | 可选 `GITHUB_TOKEN` 或 `gh auth token` |
| `search_hackernews` | 技术社区讨论 | — |
| `search_x` | X/Twitter帖子，通过xAI Grok | `XAI_API_KEY`（付费） |
- **`/research`技能** (`skills/research/`)：主题分解 → 子主题扩展 → 综合 → 带有章节和引用的报告 → 从Markdown生成HTML。选择范围（小/中/大/极大）可扩展搜索宽度。
克劳德代码本身执行网络搜索和报告编写 - 此插件提供来源和剧本。
## 要求
- [克劳德代码](https://claude.com/claude-code)
- [`uv`](https://docs.astral.sh/uv/)（Python环境管理器）- MCP服务器通过它启动
- （可选）`gh` CLI - 然后GitHub搜索自动授权
- （可选）xAI密钥和积分 - 用于X搜索
## 安装（作为插件）
```bash
git clone https://github.com/<you>/claude-research-agent
cd claude-research-agent
# 在克劳德代码中注册为本地插件：
claude plugin install ./claude-research-agent # 或将路径添加到市场配置中
```
安装后重启 `claude`，执行 `/mcp` - 应该出现 **research** 服务器，包含5个工具，并且 `/research` 应该在技能列表中。
> MCP服务器在首次启动时将使用 `uv` 安装依赖项（参见 `server/pyproject.toml`）。
## 密钥（可选）
复制 `server/.env.example` → `server/.env` 并填写必要信息：
- `XAI_API_KEY` - 启用 `search_x`（xAI Grok，付费；**每次调用**，约$0.2）。
- `GITHUB_TOKEN` - 提升GitHub限制（如果没有 `gh` CLI）。
- `OPENALEX_EMAIL` - OpenAlex的“礼貌池”（非必需）。
无需任何密钥，即可直接使用 **arXiv、OpenAlex、GitHub、黑客新闻**。
## 使用
在克劳德代码聊天中：
```
/research
```
或直接输入：“对主题X进行深入研究，并附上引用报告”。技能将询问范围，协商模式（扩展/内联），收集来源，并保存 `./research-reports/<主题>.md` + `.html`，包含指向每个来源的可点击链接（包括直接指向X帖子的链接）。
## 成本
除X外，所有功能免费。`search_x` 按**每次调用**计费（不是按帖子数量），因此技能会单独收集X，1-3次广泛调用每个报告（约$0.2-0.7）。
## 安全
`.env` 中的密钥 **不会被提交到git** （参见 `.gitignore`）。请勿公开您的密钥。
## 许可证
MIT - 参见 [LICENSE](LICENSE)。
