Facebook Marketplace Search

通过本地服务搜索附近Facebook Marketplace商品,支持多条件筛选。

已扫描
适合谁
需要查找本地二手商品的用户、从事本地生活信息整合的开发者
不适合谁
希望直接使用无需配置的服务用户、无技术能力部署本地服务的普通用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好(★☆☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @alexanderhe88/facebook-marketplace-search

Skill 说明

命令、参数、文件名以原文为准

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

可通过以下环境变量覆盖:

  • MARKETPLACE_API_BASE_URL

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

  • query
  • location
  • radius_km
  • min_price
  • max_price
  • limit
  • pickup_only
  • sort

安装步骤

安装依赖:

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

可选:复制配置文件:

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

使用方法

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

输出格式

{
  "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"
    }
  ]
}

注意事项

  • 此技能仅为客户端封装,不包含内置爬虫。
  • 它旨在与您自行控制的本地服务集成。
  • 部分上游服务可能无法始终提供卖家姓名或精确的自提信息。
  • 排序行为取决于本地服务的具体实现。
A
@alexanderhe88

已收录 2 个 Skill

相关推荐