fileclaw (R Zacharias44)

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

1. 你用简单的语言向你的人工智能请求一些东西
2. 如果查询不明确，fileclaw 识别 首先，使用元数据API（TMDb、MusicBrainz、CrossRef、MyAnimeList、开放库、维基数据）将标题解析为精确匹配
3. fileclaw搜索该类型内容的正确来源
4. 对结果进行重复数据消除、排名，并选择最佳匹配项
5. 文件可以通过任何有效的方法下载——直接下载、Real Debrid、usenet或torrent客户端
6. 完成后，您会收到通知

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 --mcp

OpenAI 代码专家

codex mcp add fileclaw -- npx -y fileclaw --mcp

Gemini 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会根据您的配置自动路由下载：

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 完整的指南。

许可证

麻省理工学院