firecrawl-search

用途

firecrawl-search 用于以用户真实问题作为查询进行自然搜索，默认返回网页结果，并同时返回相关的 Alexandria 工具匹配，可选对网页内容进行抓取。它面向网络研究、结构化数据查找以及工具与数据源发现等任务。

主要能力

基础搜索：使用自然语言查询返回网页结果。
内容抓取：通过 --scrape 从搜索结果中抓取完整网页内容。
新闻检索：可通过 --sources news 结合 --tbs qdr:d 检索过去一天的新闻。
分类索引：--categories developer 检索公开代码仓库、GitHub 议题、已合并 PR、仓库 README 和精选文档站点；--categories gov 检索美国联邦、州和地方政府法律与监管来源，且不能与其他分类组合；--categories research 是网站过滤器，并非论文索引。
政府索引：使用 firecrawl gov "<question, jurisdiction, and date>" --limit 10 进行美国法律或监管来源发现，结果出现在 data.web。
Alexandria 目录：包含现成的网站工作流、API 提供商和专用索引，可返回结构化记录、详细列表、财务数据、公司信息、研究或公开记录。
语义发现：将用户问题的含义与工具能力匹配，即使网页结果中没有相关提供商网站也可能命中。
域名匹配：显示与网页结果中网站关联的工具，表示相关性，但不证明该工具覆盖所请求字段或市场。
合约检查：搜索结果默认只返回提供商、能力和描述的紧凑匹配；需通过 firecrawl list <provider> <capability> --pretty 查看合约的输入、覆盖范围和访问要求后再执行。
工具执行：通过 firecrawl scrape <provider/capability> --options '<input JSON>' 执行，search --scrape 只抓取网页结果内容，不执行提供商工具。
已知网站发现：firecrawl find-tools <url> 可发现关联工具，但不执行。

使用方式

快速开始示例：

# 基础搜索
firecrawl search "your query" -o .firecrawl/result.json --json

# 搜索并抓取完整页面内容
firecrawl search "your query" --scrape -o .firecrawl/scraped.json --json

# 过去一天的新闻
firecrawl search "your query" --sources news --tbs qdr:d -o .firecrawl/news.json --json

渐进式发现与输出处理：

# 网页 + 域名匹配 + 语义工具
firecrawl search '<user question>'

# 仅语义工具
firecrawl search alexandria '<user question>'

# 分类 → 提供商 → 工具 → 合约
firecrawl list
firecrawl list <category-id> --category
firecrawl list <provider-id>
firecrawl list <provider-id> <capability-id> --pretty

# 执行工具
firecrawl scrape <provider-id>/<capability-id> --options '<JSON matching the selected contract>'

其他选项：--help 查看搜索选项，firecrawl list --help 查看合约浏览，firecrawl scrape --help 查看执行选项。--tool-detail summary --json 用于发现元数据与导航；--tool-detail full --json 可直接在搜索结果中接收合约并复用。--sources web 显式退出 Alexandria；--sources web --domain-tools 仅保留域名匹配。

适用场景

网络研究：使用普通搜索获取网页结果，对已知页面使用 URL scrape。
需要结构化记录、可筛选列表、转录文本或数据集时，先检查 firecrawl search alexandria '<data you need>'。
对已知网站使用 firecrawl find-tools <url>。
美国法律或监管来源发现，使用 firecrawl gov，并核查来源的发布方、司法辖区、生效状态和版本；缺少司法辖区时先询问；非美国问题或覆盖不足时使用普通搜索；无命中不能证明不存在适用法律。

限制与注意事项

政府索引不能与其他分类组合。
工具发现不等于执行；匹配不代表已获取数据。
搜索结果中的定价信息仅供参考，不是额外确认门槛。
若返回工具未覆盖所需国家/市场/细分或所需输入，应继续使用普通网页结果，不应穷举目录或为探测覆盖范围而付费使用相邻工具。
大型搜索响应应保留在 --json -o 输出中并只选取相关结果；不要将完整响应直接倾泻到上下文。
搜索请求 ID 不支持作为 Bash 恢复输入。
反馈需在搜索后约 2 分钟内发送，逾期会被拒绝。
每日退款上限（每团队每 UTC 日默认 100 积分）；当 dailyCapReached: true 时应停止当日调用。
反馈内容需实质性：good 至少包含一个 --valuable-sources；partial 需包含 --valuable-sources 或 --missing-content；bad 需包含 --missing-content 或 --query-suggestions。
同一搜索 ID 重复提交返回成功但不再额外退款。
可通过环境变量 FIRECRAWL_NO_SEARCH_FEEDBACK=1 或 FIRECRAWL_DISABLE_SEARCH_FEEDBACK=1 退出反馈；团队管理员也可在服务端禁用。
零结果搜索不写输出文件，读取搜索结果 ID 前需先确认有结果。

反馈示例

if SEARCH_ID=$(jq -er 'select(any(.data[]; length > 0)) | .id' .firecrawl/search-react-hooks.json); then
  firecrawl search-feedback "$SEARCH_ID" \
    --rating "<good|partial|bad>" \
    --valuable-sources '[{"url":"https://react.dev/reference/react/hooks","reason":"Most authoritative"}]' \
    --missing-content '[{"topic":"useDeferredValue","description":"No example of useDeferredValue with Suspense"}]' \
    --silent &
fi

--missing-content 接受 JSON 数组、"topic: description" 字符串、纯主题名列表或重复标志。--silent 抑制输出，& 后台运行。

技能介绍

用途