mcpField
F
facebook-research

facebook-research

github.com/crawlora-org营销与增长141 次安装2 天前更新
代码仓库

关于 facebook-research

通过 Crawlora API 搜索 Facebook Marketplace 的公开商品，并查询 Facebook 公共主页信息，适合本地市场调研和公开页面信息整理。结果以规范化 JSON 返回；市场搜索仅提供第一页结果。

主要功能

  1. 01按地点和条件搜索市场商品
  2. 02浏览指定地点的市场信息流
  3. 03查询公共主页关注数与类别
  4. 04获取页面公开联系信息
  5. 05以规范化 JSON 返回结果

适用场景

  1. 01比较本地二手商品标价
  2. 02浏览特定地点的市场商品
  3. 03整理潜在客户的公共主页信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill facebook-research

安装后在 Claude Code 中输入/facebook-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

Facebook 研究

搜索 Facebook Marketplace 并查询公开的 Facebook Page 详情——所有数据均来自 Crawlora API，且已规范化为 JSON，无需浏览器自动化或登录会话。

何时使用此技能

  • “查找 在 附近的 Marketplace 刊登信息。”
  • “/ 的 Marketplace 浏览动态里有什么？”
  • “获取 的关注者数量 / 类别 / 联系信息。”
  • “这个 Facebook Page 是否列出了电话号码或网站？”
  • 本地市场价格调研，或批量收集某个 Page 公开的“关于”标签页信息以开发潜在客户。

设置（一次性）

  • 获取免费的 Crawlora API 密钥（每月 2,000 个额度，无需信用卡）：https://crawlora.net。
  • 运行辅助工具前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助工具会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

  1. Marketplace 搜索 / 浏览 — 使用 GET /facebook/marketplace/search，必须提供 location（Marketplace 个性化名称 slug），并可选提供 query 或 category；省略 query 和 category 时，将返回该地点的浏览动态，而非搜索结果。min_price、max_price、sort_by、days_since_listed 和 condition 仅在提供 query 或 category 时生效。
  2. Page 查询 — 使用 GET /facebook/{page}，其中 page 可以是个性化名称、句柄、profile.php ID 或完整 Facebook URL；返回名称、关注者 / 点赞数、简介、类别、营业时间 / 价格范围、评论数，以及 Page“关于”标签页上的任何公开联系信息。

完整的端点列表、方法和参数见：reference/endpoints.md。

调用 API

# Marketplace search / browse:
scripts/crawlora.sh /facebook/marketplace/search location=chicago-il query="dining table" | jq '.'
scripts/crawlora.sh /facebook/marketplace/search location=chicago-il category=vehicles min_price=5000 | jq '.'

# Page lookup:
scripts/crawlora.sh /facebook/nike | jq '.'

所有请求均使用 scripts/crawlora.sh；它不会将 API 密钥暴露在命令行参数中。

端点参考

此技能使用的两个 Facebook 端点见 reference/endpoints.md。

示例

  • 本地二手商品价格查询： 使用 /facebook/marketplace/search，通过 location 和商品 query 查询，再比较第一页结果中的标价和成色。
  • 商家潜在客户信息补充： 使用 /facebook/{page} 查询潜在客户的 Facebook Page，从“关于”标签页获取关注者数量、类别，以及任何公开的电话 / 电子邮件 / 网站信息，以便后续联系。

注意事项与限制

  • 额度 / 成功后计费： 仅对 2xx 响应计费；免费套餐每月提供 2,000 个额度。获取密钥：https://crawlora.net。
  • 仅限公开数据——公开的 Marketplace 刊登信息和公开的 Page 信息；无需登录，不含私密内容。请遵守 Facebook 的条款。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、作为查询参数传递或提交到代码库。
  • Marketplace 搜索仅支持单页：Facebook 自身的后续分页需要登录会话，不在支持范围内——仅返回服务器渲染结果的第一页。
  • property_rentals 类别始终使用专属筛选——它有自己的刊登页面，并且与普通浏览动态一样，会忽略 min_price / max_price / sort_by 等筛选条件。
  • Marketplace 搜索可能较慢——最慢情况下约需一分钟，因为服务会针对间歇性上游状况重试；相应的计费也考虑了这一点。

评论

支持 Markdown