SuperAPI AI 工具集

facebook-research

数据与分析

查看项目

更新于 10-15 20:29

技能介绍

用途:搜索 Facebook Marketplace 商品列表,以及查询公开 Facebook 主页详情,返回归一化 JSON,无需浏览器自动化或登录会话。适用于本地市场价格调研,或对主页公开 About 标签进行线索搜集。

主要能力:Marketplace 搜索/浏览使用 GET /facebook/marketplace/search,必填 location(Marketplace 虚荣 slug),可选 query 或 category;两者都省略时返回该位置的浏览流。min_price、max_price、sort_by、days_since_listed、condition 仅在同时提供 query 或 category 时生效。主页查询使用 GET /facebook/{page},page 可为虚荣名、句柄、profile.php id 或完整 Facebook URL,返回名称、粉丝/点赞数、简介、类别、营业时间/价格区间、评论数及 About 标签上的公开联系方式。

使用方式:先在 https://crawlora.net 获取免费 Crawlora API key(每月 2000 额度,无需信用卡),设置环境变量 CRAWLORA_API_KEY,请求发往 https://api.crawlora.net/api/v1,缺少或无效 key 返回 401。示例:scripts/crawlora.sh /facebook/marketplace/search location=chicago-il query="dining table" | jq '.';scripts/crawlora.sh /facebook/nike | jq '.'。使用 scripts/crawlora.sh 可避免 key 出现在命令行参数中。

限制:仅限公开数据,不登录、不访问私密内容,需遵守 Facebook 条款;Marketplace 搜索仅单页,Facebook 自身翻页需登录会话,不在范围内;property_rentals 类别始终被过滤,忽略价格/排序等筛选;搜索可能较慢,最慢约一分钟;按成功计费,仅 2xx 计费;key 只存于环境变量,切勿硬编码、作为查询参数或提交。完整端点列表见 reference/endpoints.md。