fileclaw
让你的人工智能在互联网上为你找到任何文件。确实如此。
fileclaw是一个 MCP服务器 这使Claude、Codex、Gemini CLI、Cursor、Windsurf和任何兼容MCP的客户端能够搜索28个源、下载文件和流式传输视频——所有这些都是通过自然对话实现的。书籍、报纸、电影、电视、动漫、漫画、音乐、游戏、ROM、软件、字幕——如果有，fileclaw可能会找到它。
它是什么样子的
你： 为我找到“设计数据密集型应用程序”的EPUB 克劳德： 在Library Genesis上找到了它（14MB，EPUB）。正在下载。..保存到~/下载/
你： 给我1080p的Sintel 克劳德： 在YTS上找到（1.4GB，1080p蓝光）。正在发送到Real Debrid…下载完成。
你： 溪大巴克兔 克劳德： 找到了一个1080p的副本。现在在VLC打开。
你： 我需要DOI为10.1038/nature12373的纸张 克劳德： 在Sci-Hub上找到。已将PDF下载到~/下载/
你： 给我找所有关于意象排练疗法的论文 克劳德： 通过Semantic Scholar找到35篇论文。从Sci-Hub下载28个PDF。..保存到~/下载/论文/
你： 给我FLAC的完整唱片 克劳德： 通过MusicBrainz找到了9张录音室专辑。正在搜索完整的唱片包。..找到一个（12GB，FLAC）。发送到真正的Debrid。
无需手动搜索，无需浏览粗略的网站，无需配置torrent客户端。问问你的AI。
运作原理
You --> Claude / Codex / Gemini CLI --> fileclaw --> 28 sources
| |
identify first LibGen, Sci-Hub, Anna's Archive,
(TMDb, MAL, YTS, Nyaa, The Pirate Bay, FitGirl,
MusicBrainz, Internet Archive, MangaDex, Soulseek, ...
CrossRef, ...) |
Download via:
Direct HTTP / Real-Debrid /
Usenet / Torrent client- 你用简单的语言向你的人工智能请求一些东西
- 如果查询不明确，fileclaw 识别 首先，使用元数据API（TMDb、MusicBrainz、CrossRef、MyAnimeList、开放库、维基数据）将标题解析为精确匹配
- fileclaw搜索该类型内容的正确来源
- 对结果进行重复数据消除、排名，并选择最佳匹配项
- 文件可以通过任何有效的方法下载——直接下载、Real Debrid、usenet或torrent客户端
- 完成后，您会收到通知
fileclaw会随着时间的推移而学习：提供良好结果的来源在未来的搜索中排名更高。
安装
最快的方式
npx fileclaw setup交互式向导——配置下载，在Claude Desktop或Claude Code中注册MCP服务器。不到一分钟就完成了。
克劳德桌面版
增添 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"fileclaw": {
"command": "npx",
"args": ["-y", "fileclaw", "--mcp"]
}
}
}重新启动克劳德桌面。让克劳德找点东西。
故障排除：“生成进程失败”/“没有这样的文件或目录” 桌面应用程序（Claude、Cursor等）不会继承shell的PATH。如果您使用以下方式管理Node fnm, 非易失性存储器，或 伏打,npx找不到。修复选项： - 使用bunx相反 （如果您通过Homebrew安装了Bun）： ``json { "command": "bunx", "args": ["fileclaw", "--mcp"] }`- **使用完整路径npx** （找到它which npx在您的终端中）：`json { "command": "/Users/you/.local/share/fnm/aliases/default/bin/npx", "args": ["-y", "fileclaw", "--mcp"] }`` - 使用独立二进制文件 --无需节点/Bun（见下文）
克劳德代码
claude mcp add fileclaw -- npx -y fileclaw --mcpOpenAI 代码专家
codex mcp add fileclaw -- npx -y fileclaw --mcpGemini CLI
增添 ~/.gemini/settings.json:
{
"mcpServers": {
"fileclaw": {
"command": "npx",
"args": ["-y", "fileclaw", "--mcp"]
}
}
}光标/风帆
两者都支持MCP服务器。添加到您的项目 .cursor/mcp.json 或 .windsurf/mcp.json:
{
"mcpServers": {
"fileclaw": {
"command": "npx",
"args": ["-y", "fileclaw", "--mcp"]
}
}
}任何兼容MCP的客户端
fileclaw通过stdio使用标准MCP。为您的客户指出：
npx -y fileclaw --mcp注： MCP服务器在启动时加载一次代码。如果编辑源文件，请重新启动服务器以使更改生效——重新启动MCP客户端或启动新会话。
独立二进制
下载自 --无需节点/Bun。
./fileclaw search "sintel" --type=video
./fileclaw --mcp # start as MCP server它能找到什么
书籍和论文 --LibGen、Sci-Hub、安娜档案馆、互联网档案馆 按标题、作者、ISBN或DOI搜索。直接下载，无需下载种子。
电影和电视 --YTS、EZTV、海盗湾、Nyaa、Stremio插件、Torrents CSV 找到可用的最佳质量。直接流式传输到VLC/mpv或通过Real Debrid下载。
音乐 --Soulseek、AudioBookBay、Piped、Librivox、Nyaa、互联网档案馆 Soulseek为您提供来自大规模P2P网络的无损FLAC。有声读物的AudioBookBay。Librivox提供免费的公共领域有声读物。
动漫与漫画 --Nyaa、MangaDex、WeebCentral 动漫如潮，逐章阅读或批量下载漫画。
游戏 --FitGirl、DODI、Myrient、RomHeaven、MarioCube 为每台主机重新包装PC游戏和复古ROM。
软件 --FileCR，海盗湾，Torrents CSV，互联网档案 Mac和PC应用程序。
字幕 --OpenSubtitles、YTS Subs 根据语言偏好自动匹配您的下载。
高级用户来源 --Prowlarr，Newznab索引器 Prowlarr在一个API后面聚合了几十个torrent和usenet索引器。Newznab允许直接访问像NZBgeek这样的usenet索引器。两者都需要一个API密钥或自托管实例。
28个源中有19个使用零配置。对于其余部分，您只需要一个API密钥。
智能消歧
fileclaw在搜索之前会识别您要查找的内容。问一些模棱两可的问题，它会先解决：
- 论文 --通过CrossRef和Semantic Scholar将标题解析为DOI，然后从Sci-Hub获取确切的PDF
- 电视/电影 --使用TMDb（或维基数据作为无键回退）来区分电影和电视节目，查找季节和解析电影图
- 音乐 --向MusicBrainz查询艺术家、专辑和完整唱片
- 动漫/漫画 --使用MyAnimeList来消除动漫系列、电影、OVA和漫画之间的歧义
- 游戏 --通过维基数据解析平台、版本和完整的特许经营列表
- 软件 --通过维基数据识别版本、平台和许可证
- 书籍 --通过开放库解析作者和系列
集合
一步找到整个收藏集：
- Discographs --按格式筛选的艺术家的所有专辑
- 电视季 --一季所有剧集，以包为先搜索
- 电影记录 --导演或演员的所有电影
- 丛书 --作者或系列中的所有作品
- 游戏特许经营权 --系列中的所有标题，包含平台信息
- 漫画系列 --所有章节或卷
fileclaw首先搜索完整的包（最有效），然后并行地返回单个项目搜索。
发布下载工具
fileclaw不仅限于下载，它还可以组织您的文件：
- 提取 --解压缩存档（zip、rar、7z、tar.gz）。检测魔术字节的格式。选择是否删除原件。
- 组织 --使用元数据和命名模板重命名和移动文件。内置Plex/Jellyfin兼容默认值，或指定您自己的（例如。
Movies/{title} ({year})/{title}.{ext}).支持模拟运行预览。 - 搁置 --使用元数据（标题、作者、ISBN、标签、系列）将书籍添加到Calibre库中。可选择转换格式（例如EPUB→ MOBI for Kindle）。
你： 解压缩游戏重新包装并删除存档 克劳德： 已将47个文件（18.2 GB）提取到~/Downloads/Elden Ring。原始存档已删除。
你： 为Plex组织该电影 克劳德： 移动到~/下载/电影/盗梦空间（2010）/盗梦世界（2010）.mkv
学术工具
由Semantic Scholar提供支持的内置研究工作流程：
- 研究 --按主题、作者或机构搜索论文
- 文献综述 --用聚类、开创性论文和引文分析来绘制研究主题。根据要求，通过Sci-Hub/LibGen自动下载PDF。
- cite_chase --从论文中前后追踪引文链
- 下载_个人 --DOI通过Sci-Hub、LibGen和Anna's Archive批量下载PDF
可选的Zotero集成，用于管理您的库。
下载方式
fileclaw会根据您的配置自动路由下载：
| 方法 | 最适合 | 安装 |
|---|---|---|
| 直接HTTP | 书籍、论文、字幕 | 没什么——开箱即用 |
| 真正的债务 | 电影、电视、游戏、软件 | API密钥（约3美元/月）-推荐用于种子 |
| 新闻组网络系统 | Everything | NZBGet或SABnzbd+索引器 |
| Torrent客户端 | 一切 | qBittorrent或传输 |
Real Debrid是最简单的升级：它在云中下载种子，并为您提供快速的直接链接。不需要torrent客户端。
配置
~/.config/fileclaw/config.json --或者干脆让克劳德跑 setup() 它引导你以对话的方式完成它。
Example config
{
"download_dir": "~/Downloads",
// Torrent downloads via Real-Debrid (recommended)
"realdebrid": {
"api_key": "YOUR_KEY",
"prefer": true
},
// Usenet (pick one)
"usenet": {
"type": "sabnzbd", // "nzbget", "nzbget-cli", or "sabnzbd"
"url": "http://localhost:8080",
"api_key": "YOUR_KEY"
},
// Extra sources that need API keys
"sources": {
"newznab": [
{ "name": "nzbgeek", "url": "https://api.nzbgeek.info", "api_key": "YOUR_KEY" }
],
"opensubtitles": { "api_key": "YOUR_KEY" }
},
// Media player for streaming (auto-detected if omitted)
"player": "vlc",
// Optional: TMDb API key for richer TV/film identification (free at themoviedb.org)
// Without it, Wikidata is used as a fallback — still works, just less detailed
"tmdb_api_key": "YOUR_TMDB_KEY",
// Optional: FlareSolverr for bypassing Cloudflare on protected sources (e.g. DODI)
// Run via Docker: docker run -p 8191:8191 ghcr.io/flaresolverr/flaresolverr
"flaresolverr": { "url": "http://localhost:8191/v1" }
}Disable a source
{ "sources": { "tpb": false } }Usenet setup
NZBGet命令行界面 （最轻--无守护进程）：
{ "usenet": { "type": "nzbget-cli" } }需求 brew install nzbget 和 ~/.nzbget 使用您的usenet服务器凭据。
NZBGet守护进程:
{ "usenet": { "type": "nzbget", "url": "http://localhost:6789", "username": "nzbget", "password": "tegbzn6789" } }SABnzbd:
{ "usenet": { "type": "sabnzbd", "url": "http://localhost:8080", "api_key": "YOUR_SAB_API_KEY" } }命令行界面
fileclaw也可以作为一个独立的命令行工具：
fileclaw search "machine learning" --type=book
fileclaw stream "big buck bunny" --player=vlc
fileclaw scan ~/Downloads/file.mkv
fileclaw health
fileclaw stats
fileclaw setup安全
下载的文件可以通过ffprobe扫描安全问题——魔术字节不匹配、嵌入式可执行文件和媒体编解码器验证。只需让你的AI扫描文件，或使用 fileclaw scan .
发展
git clone https://codeberg.org/rzacharias/fileclaw && cd fileclaw
bun install
bun run cli search "sintel" # CLI from source
bun run dev # MCP server (stdio)
bun run typecheck # type check
SKIP_INTEGRATION=1 bun test # unit tests (219 tests)
bun test # all tests including integration
bun run build # bundle dist/建筑
src/
sources/ 28 source implementations — each exports search(), healthCheck(), resolve()
metadata/ Disambiguation resolvers (TMDb, MusicBrainz, Open Library, CrossRef, Jikan, Wikidata)
academic/ Semantic Scholar client, Zotero integration
tools/ Core logic: search, download, stream, scan
mcp/ MCP server + 19 tool registrations
download/ Download routing: Real-Debrid, usenet, torrent client
http.ts Shared HTTP client with Cloudflare detection + FlareSolverr fallback
config.ts User config (~/.config/fileclaw/config.json)
quality.ts Source ranking — learns from usage over time每个源都是一个自包含的模块，实现了共享 Source 界面。添加一个新的源代码需要大约100行TypeScript。看 贡献.md.
贡献
想添加源吗？每个源代码都是一个文件（约50行实际代码），实现了 search() 和 healthCheck() 方法。有一个 复制粘贴模板 准备出发。
fileclaw contribute add mysite https://... # scaffold a new source from template
fileclaw contribute check libgen # diagnose a broken source
fileclaw contribute pr # fork + commit + open PR看看 好的第一个问题 或 源请求 对于想法，或 请求新的来源 你自己。
看 贡献.md 完整的指南。
许可证
麻省理工学院