search: --categories rejects "developer" client-side although POST /v2/search accepts it
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 2/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 75/100
- Issue 类型
- 缺陷
- 描述清晰度
- 描述清楚
- 活跃度
- 活跃
- 技术栈
- node.js, typescript
- 领域
- cli
调研方向
从 dist/index.js 第 701 行开始，将 CLI 类别验证与托管的 MCP 类别 enum 以及 issue 中描述的 API 行为进行比较。使用 --categories developer 运行提供的 firecrawl 搜索命令；当 CLI 接受 developer 并成功发送请求，而不是在本地拒绝请求时，即表示完成。
由索引模型根据 Issue 内容生成。
描述
Summary
firecrawl search --categories developer exits 1 with Error: Invalid category "developer". Valid categories: github, research, pdf before any request is made, but the API accepts the category and returns results tagged developer.
Version
firecrawl-cli 1.19.26 (npm), Node 24.12.0, Linux.
Where
dist/index.js line 701 in the published package:
const validCategories = ['github', 'research', 'pdf'];
Reproduction
$ firecrawl search "foundationdb queue worker shutdown" --categories developer --limit 2 --json
Error: Invalid category "developer". Valid categories: github, research, pdf
The same request against the API succeeds (2026-09-13):
POST https://api.firecrawl.dev/v2/search
{"query": "foundationdb queue worker shutdown", "categories": ["developer"], "limit": 2}
-> HTTP 200, success: true, creditsUsed present, results with "category": "developer"
(forums.foundationdb.org pages, which the github category does not return)
The hosted MCP server's firecrawl_search tool already lists developer in its categories enum alongside github, research, and pdf.
Suggested fix
Add 'developer' to validCategories, or drop the client-side list and let the API validate so new categories work without a CLI release.
- 主要语言
- TypeScript
- 星标
- 635
- 派生
- 106
- 平均合并
- 4 小时 16 分钟
- 30 天内合并 PR
- 48
环境准备
我们还没有检查这个项目的环境配置文件。先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
firecrawl/cli 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 74/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
firecrawl/cli#160 · 1 个 reaction ·
维护者通常 1 天内回复
-
难度 1/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
相似的 Issue
-
triage
难度 1/5 1 小时以内 新手友好度 90/100
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 68/100
mermaid-js/mermaid-live-editor#2053 ·
维护者通常 1 天内回复
-
factory
难度 2/5 1-3 小时 新手友好度 82/100
jessepollak/home#1455 ·
维护者通常 1 天内回复
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
难度 1/5 1 小时以内 新手友好度 95/100
lingdojo/kana-dojo#31227 · 1 条评论 · 5 个 reaction ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 92/100
appandflow/stim#1838 ·
维护者通常 1 天内回复