Alexandria

Alexandria 让代理通过 Firecrawl 访问结构化数据。发现工具、查看其输入参数，然后运行。发现工具免费；执行则会消耗工具上标注的额度。浏览提供商 · 管理提供商条款

为代理而生

安装 CLI 或连接 MCP server。

Firecrawl CLI
MCP

# 在网页结果之外同时查找工具。
firecrawl search "podcast conversations about AI agents" --sources web,alexandria --domain-tools --limit 2

# 查看输入参数与定价。
firecrawl find-tools --providers particle --level tools --expand options,response

# 运行该工具。
firecrawl scrape particle/podcasts/episodes/search --options '{"keyword_search":"AI agents","limit":2}'

使用 npm install -g firecrawl-cli 安装，并通过 firecrawl login 登录。

向你的代理提问：“找到 Particle 的播客工具，查看剧集搜索的输入参数与定价，然后找出关于 AI 代理的对话。”该代理会用 firecrawl_search 发现工具，用 firecrawl_find_tools 查看工具详情，再用 firecrawl_scrape 执行工具。

通过 SDKs 和 API 使用

找到合适的工具

描述你的需求，Alexandria 会在返回网页结果的同时给出相关工具。

const result = await firecrawl.search(
  "podcast conversations about AI agents",
  {
    sources: ["web", "alexandria"],
    limit: 2,
  },
);

result = firecrawl.search(
    "podcast conversations about AI agents",
    sources=["web", "alexandria"],
    limit=2,
)

curl https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "podcast conversations about AI agents",
  "sources": [
    "web",
    "alexandria"
  ],
  "limit": 2
}'

结果中包含 web 页面和已排序的 tools。每个工具都会给出其提供商、功能、输入参数、响应约定和执行价格。

确认工具的调用要求

调用前，先查看所选工具的 options、response 和执行价格。更多细节参见 Find Tools。

获取数据

使用 scrape 调用该工具，并按其约定传入相应输入参数。在 alexandria 下指定 provider 和 capability，无需提供页面 URL。

const episodes = await firecrawl.scrape({
  alexandria: {
    provider: "particle",
    capability: "podcasts/episodes/search",
    options: {
      semantic_search: "AI agents",
      limit: 2,
    },
  },
});

console.log(episodes.alexandria[0].data);

episodes = firecrawl.scrape(
    alexandria={
        "provider": "particle",
        "capability": "podcasts/episodes/search",
        "options": {
            "semantic_search": "AI agents",
            "limit": 2,
        },
    },
)

print(episodes.alexandria[0].data)

REQUEST_ID="$(uuidgen)"

curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "x-request-id: $REQUEST_ID" \
  -d '{
  "alexandria": {
    "provider": "particle",
    "capability": "podcasts/episodes/search",
    "options": {
      "semantic_search": "AI agents",
      "limit": 2
    }
  }
}'

从 episodes.alexandria[0].data 读取结果。使用数据前，请先检查每个工具结果是否报错。原始 HTTP 响应会将 SDK 结果包装在 data 中。

Find Tools

使用 findTools / find_tools 即可免费浏览提供商并查看其工具。沿着某个条目的 next 请求可获取更多详情；顶层的 next 用于对目录分页。

const catalogue = await firecrawl.findTools({
  providers: ["particle"],
  limit: 2,
});

// 每个 next 请求都会展现目录的另一部分。
const next = catalogue.items[0]?.next;
if (next) {
  const details = await firecrawl.scrape({ alexandria: next });
  console.log(details.alexandria[0].data);
}

catalogue = firecrawl.find_tools(providers=["particle"], limit=2)

if catalogue.items and catalogue.items[0].get("next"):
    details = firecrawl.scrape(alexandria=catalogue.items[0]["next"])
    print(details.alexandria[0].data)

价格与访问

工具发现： 免费。使用 sources: ["alexandria"] 仅获取工具，或使用 ["web", "alexandria"] 同时包含付费的网页结果。
执行： 按工具标价计费。
提供商条款： THIRD_PARTY_DATA_TERMS_REQUIRED 错误中会包含 requiresAction.url。组织管理员需在该页面查看并接受条款。代理在接受条款前须获得用户的明确授权。

为某个网站查找工具

在搜索或普通的 URL 抓取中添加 domainTools: true，即可包含与该网站匹配的工具。匹配免费；网页搜索或页面抓取照常计费。结果中会包含 matchedBy 和 matchedUrls。当 sources 包含 alexandria 时，搜索默认启用域名匹配，可设置 domainTools: false 将其关闭。对于 URL 抓取，域名匹配默认关闭。

Feedback

使用 firecrawl alexandria feedback 报告 issue 或请求新功能。运行 firecrawl alexandria feedback --help 查看选项。

快速上手

核心端点

更多

快速入门

开发者指南

Webhooks

使用场景

其他

参与贡献

为代理而生

通过 SDKs 和 API 使用

Find Tools

价格与访问

Feedback

​为代理而生

​通过 SDKs 和 API 使用

​Find Tools

​价格与访问

​Feedback

为代理而生

通过 SDKs 和 API 使用

Find Tools

价格与访问

Feedback