内容
# 🤿 社交探索
[](https://github.com/krishddd/social_dive/actions/workflows/ci.yml)
[](https://badge.fury.io/py/social-dive)
[](https://opensource.org/licenses/MIT)
**社交探索** 是一个为 20 多个知识源提供互联网访问能力的 AI 代理层。
它作为安装程序、诊断工具、配置工具和执行层，连接 AI 代理（如 Claude Code、Cursor、Windsurf 等）与 arXiv、GitHub、YouTube、维基百科、PubMed、Semantic Scholar、Hacker News、Stack Overflow、DEV.to、RSS 源、Crossref DOIs、OpenAlex、Europe PMC 和更广泛的网络等平台。
> 📖 **想了解其内部工作原理？** 请阅读 [项目架构摘要](SUMMARY.md)。
社交探索采用混合 **Python** 和 **Rust** 架构，具有高性能的 HTML 转 Markdown 解析和并发 HTTP 获取功能，不会锁定 Python GIL。
## 功能
- **多源读取与搜索：** 16 多个互联网源原生支持，无需复杂的爬虫工具。
- **LLM 集成：** 与 NVIDIA NIM（DeepSeek、GLM、MiniMax）、OpenAI 和 Anthropic 无缝集成。
- **包含 MCP 服务器：** 向任何与 MCP 兼容的 AI 代理公开其功能。
- **零配置选项：** 大多数源无需 API 密钥即可开箱即用。
- **高性能：** 使用 Rust 核心进行 HTML 解析和并发获取。
## 安装
```bash
pip install social-dive
```
*（可选）安装特定 LLM 提供商支持：*
```bash
pip install "social-dive[anthropic]"
```
## 快速入门
检查系统健康状况和可用频道：
```bash
social-dive doctor
```
从任何支持的 URL 读取内容（返回干净的 Markdown）：
```bash
social-dive read https://arxiv.org/abs/2401.12345
```
使用 LLM 总结网页内容：
```bash
social-dive summarize https://en.wikipedia.org/wiki/Artificial_intelligence
```
跨学术或代码源搜索：
```bash
social-dive search "Transformer architecture" --channels=arxiv,semantic_scholar
```
## 配置
安全地配置您的 LLM 提供商和 API 密钥：
```bash
# 设置 LLM 提供商（nvidia、openai 或 anthropic）
social-dive configure llm_provider nvidia
# 设置您的 API 密钥
social-dive configure nvidia_api_key "nvapi-..."
social-dive configure github_token "ghp_..."
# 查看当前配置
social-dive configure --list
```
配置信息安全存储在 `~/.social-dive/config.yaml` 中，具有严格的文件权限（`0600`）。
## 模型上下文协议（MCP）
社交探索包含一个内置的 MCP 服务器，以便您的 AI 代理可以直接调用其工具。
使用以下命令启动服务器：
```bash
python -m social_dive.integrations.mcp_server
```
### 可用的 MCP 工具：
- `read_url`：读取并提取任何 URL 的内容。
- `search_sources`：跨学术、代码和网络源进行搜索。
- `check_health`：报告频道可用性。
- `summarize_url`：使用配置的 LLM 总结内容。
- `list_channels`：列出所有可用的知识频道。
## 支持的频道
| 频道 | 描述 | 等级 |
|---------|-------------|------|
| `arxiv` | 学术预印本 | 零配置 |
| `github` | 仓库、问题、拉取请求 | 需要密钥 |
| `youtube` | 视频转录 | 零配置 |
| `wikipedia` | 词条文章 | 零配置 |
| `semantic_scholar` | 学术论文 | 需要密钥（可选） |
| `pubmed` | 生物医学文献 | 需要密钥 |
| `hacker_news` | 技术新闻 + 讨论 | 零配置 |
| `stack_overflow` | 编程问答 | 需要密钥（可选） |
| `devto` | 开发者文章 | 零配置 |
| `crossref` | DOI 元数据 | 零配置 |
| `openalex` | 学术作品 | 需要密钥 |
| `europe_pmc` | 开放获取论文 | 需要密钥 |
| `rss` | RSS/Atom 源 | 零配置 |
| `doi_resolver` | DOI →全文 | 零配置 |
| `web` | 万能网络阅读器 | 零配置 |
## 许可证
该项目根据 MIT 许可证授权。有关详细信息，请参见 [LICENSE](LICENSE)。
