Facebook Marketplace 搜索

通过用户提供的本地Marketplace服务搜索附近的Facebook Marketplace列表。

设计目标

此发布的技能有意设计为轻量级客户端封装。

它不包含：

• - 嵌入的Facebook抓取逻辑
• 第三方Marketplace抓取代码
• 内置后台服务
• LaunchAgent安装程序

这种设计使得发布的包更小巧、更易于审查，并且从安全扫描角度来看敏感性更低。

该技能的功能

• - 向本地兼容Marketplace的服务发送搜索请求
• 支持：

- query（查询） - location（位置） - radius_km（半径公里数） - min_price（最低价格） - max_price（最高价格） - limit（限制数量） - pickup_only（仅自提） - sort（排序方式）

• - 返回标准化JSON数据，包含：

- id（编号） - title（标题） - price（价格） - location（位置） - seller_name（卖家名称） - image_url（图片链接） - listing_url（列表链接）

预期的本地服务

默认情况下，此客户端调用：

• - http://127.0.0.1:8787/search

可通过以下方式覆盖：

• - MARKETPLACEAPIBASE_URL

本地服务应接受如下查询参数：

• - query
• location
• radiuskm
• minprice
• maxprice
• limit
• pickuponly
• sort

设置

安装依赖：

bash
python3 -m pip install -r skills/facebook-marketplace-search/requirements.txt

可选地复制配置：

bash
cp skills/facebook-marketplace-search/config.example.json \
skills/facebook-marketplace-search/config.json

使用方法

bash
python3 skills/facebook-marketplace-search/scripts/facebookmarketplacesearch.py \
--query burrow sofa \
--location Livingston, NJ \
--radius-km 48 \
--limit 10 \
--sort local_first

输出格式

json
{
query: burrow sofa,
location: Livingston, NJ,
count: 2,
results: [
{
id: 123,
title: Burrow Sofa,
price: 400.0,
location: Livingston, NJ,
seller_name: Jane Doe,
image_url: https://...,
listing_url: https://www.facebook.com/marketplace/item/123
}
]
}

注意事项

• - 此技能是一个客户端封装，而非捆绑的抓取工具。
• 它旨在与您控制的本地服务集成。
• 某些上游服务可能无法始终提供卖家名称或精确的自提语义。
• 排序行为取决于本地服务的实现。