pp-facebook-marketplace

Facebook Marketplace — Printing Press CLI

前置要求：安装 CLI

此技能由 facebook-marketplace-pp-cli 二进制文件驱动。**调用此技能中的任何命令前，必须先确认 CLI 已安装。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install facebook-marketplace --cli-only
   

2. 验证：facebook-marketplace-pp-cli --version
3. 确保报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（例如没有 Node、处于离线状态等），请改用直接 Go 安装（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/commerce/facebook-marketplace/cmd/facebook-marketplace-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功前，请勿继续执行技能命令。

何时使用此 CLI

在本地、由人工把控节奏的 Facebook Marketplace 工作流中使用此 CLI，例如搜索、关注、筛选匹配项、起草商品信息，以及在获得明确批准后回复卖家收件箱中的消息。请避免将其用于批量自动化或跨平台抓取。

独特功能

这些功能是其他任何用于此 API 的工具都不具备的。

卖家工作流

• draft — 根据照片和备注起草 Marketplace 标题、描述并提供价格建议。

  在准备卖家商品信息、但尚未进入受写入权限控制的发布流程时使用此功能。

  facebook-marketplace-pp-cli draft --photos chair-front.jpg,chair-tag.jpg --notes "walnut dining chair, small scratch on back" --json
  

• reply — 仅当 --write 和 doctor 门控检查均通过时，准备并发送卖家收件箱回复。

  仅用于经人工批准的卖家消息。

  facebook-marketplace-pp-cli reply --thread 1525836598898750 --message "Yes, it is still available." --write --json
  

买家工作流

• watch add — 创建并保存 Marketplace 搜索关注项，应用确定性的关键词、价格和距离筛选条件。

  当 Agent 需要监控 Marketplace，而无需对每条原始结果逐一判断相关性时使用此功能。

  facebook-marketplace-pp-cli watch add --name "eames" --query "eames lounge" --max-price 1500 --radius 60 --must-have-keywords "chair,lounge" --json
  

• matches — 显示经过确定性筛选后的新增关注匹配项。

  当 Agent 需要整理出值得展示给人类买家的候选列表时使用此功能。

  facebook-marketplace-pp-cli matches --new --json
  

本地镜像

• stale — 查找超过七天且没有互动的本地卖家商品信息。

  在决定哪些卖家商品信息需要调整价格或续期时使用此功能。

  facebook-marketplace-pp-cli stale --days 7 --json
  

HTTP 传输

此 CLI 使用兼容 Chrome 的 HTTP/3 传输方式访问面向浏览器的端点。执行常规 API 调用时，无需运行常驻浏览器进程。

命令参考

composer — 面向卖家的发布助手操作。

• facebook-marketplace-pp-cli composer price_prediction — 获取 Marketplace 发布助手的价格预测。
• facebook-marketplace-pp-cli composer root — 获取 Marketplace 商品发布助手的元数据。
• facebook-marketplace-pp-cli composer shipping_options — 获取草稿商品的计算运费选项。

inbox — Marketplace 收件箱和消息操作。

• facebook-marketplace-pp-cli inbox list — 获取 Marketplace 收件箱概览。
• facebook-marketplace-pp-cli inbox thread — 按 thread id 获取 Marketplace/Messenger 私聊对话。
• facebook-marketplace-pp-cli inbox message_seller — 向 Marketplace 卖家发送消息。
• facebook-marketplace-pp-cli inbox seller_threads — 获取 Marketplace 卖家收件箱对话。
• facebook-marketplace-pp-cli inbox seller_threads_page — 获取一页 Marketplace 卖家收件箱对话。

listing — 商品详情和面向卖家的商品操作。

• facebook-marketplace-pp-cli listing change_availability — 更改 Marketplace 商品的可售状态。
• facebook-marketplace-pp-cli listing create — 根据准备好的发布助手负载创建 Marketplace 商品；传入 --photo 可先上传本地照片。
• facebook-marketplace-pp-cli listing delete — 删除 Marketplace 待售商品。
• facebook-marketplace-pp-cli listing get — 获取 Marketplace 商品详情页负载。
• facebook-marketplace-pp-cli listing media — 获取 Marketplace 商品媒体负载。
• facebook-marketplace-pp-cli listing upload-photo — 上传本地照片并返回 Marketplace 发布助手的 photo_id。

marketplace — Marketplace 浏览和位置操作。

• facebook-marketplace-pp-cli marketplace browse_feed — 获取 Marketplace 浏览信息流结果。
• facebook-marketplace-pp-cli marketplace set_browse_radius — 设置 Marketplace 浏览半径。
• facebook-marketplace-pp-cli marketplace set_buy_location — 设置 Marketplace 购买位置。

marketplace_search — Marketplace 搜索操作。

• facebook-marketplace-pp-cli marketplace_search — 搜索 Marketplace 商品。

手写命令

• facebook-marketplace-pp-cli draft — 根据照片和备注生成 AI 商品草稿。
• facebook-marketplace-pp-cli watch — 面向买家的确定性监控命令。
• facebook-marketplace-pp-cli matches — 显示经过确定性筛选后的监控匹配项。
• facebook-marketplace-pp-cli stale — 显示超过七天且没有互动的本地商品。
• facebook-marketplace-pp-cli reply — 受写入门控的面向卖家消息回复助手。

找到合适的命令

知道想做什么，但不知道该用哪个命令时，可以直接询问 CLI：

facebook-marketplace-pp-cli which "<capability in your own words>"

which 会根据自然语言功能查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示没有可信的匹配项，此时可改用 --help 或使用范围更窄的查询。

使用示例

创建一个面向买家的监控

facebook-marketplace-pp-cli watch add --name "eames" --query "eames lounge" --max-price 1500 --radius 60 --json

在本地存储确定性筛选条件，以便后续运行时比较新商品。

阅读 Marketplace 买家的私聊对话

facebook-marketplace-pp-cli inbox thread --thread 27799138726406206 --agent

读取已知 Marketplace thread id 对应的真实 Messenger 对话路由，并返回解析后的摘要以及消息文本、发送者 id 和时间戳。

起草卖家商品信息

facebook-marketplace-pp-cli draft --photos chair-front.jpg,chair-tag.jpg --notes "walnut dining chair, small scratch" --json

在任何受写入门控的 Marketplace 修改操作之前生成商品文案。

要使用本地照片创建商品，先运行 facebook-marketplace-pp-cli doctor，然后向 listing create 传入 --write 和一个或多个 --photo 标志。CLI 会上传每个本地文件，将返回的 photo_id 值追加到 variables.input.data.common.photo_ids，然后提交创建修改操作。

身份验证设置

在 Chrome 中登录 Facebook 后，运行 facebook-marketplace-pp-cli auth login --chrome。捕获的浏览器会话就是凭据；不要将会话材料存储在 Dropbox 项目工作区中。

运行 facebook-marketplace-pp-cli doctor 验证设置。

Agent 模式

在任意命令后添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可管道传输 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 会保留部分字段。点分路径可深入嵌套结构；数组会逐元素遍历。对于输出冗长的 API，这是控制上下文大小的关键：

  facebook-marketplace-pp-cli inbox list --fb-api-req-friendly-name example-resource --agent --select id,name,status
  

• 可预览 — --dry-run 显示请求，但不发送

• 非交互式 — 从不提示输入，每个输入项都是一个标志

• 显式重试 — 仅当已存在的创建操作也应视为成功时，才使用 --idempotent

Agent 反馈

当你（或 Agent）发现此 CLI 有不妥之处时，请记录下来：

facebook-marketplace-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
facebook-marketplace-pp-cli feedback --stdin < notes.txt
facebook-marketplace-pp-cli feedback list --json --limit 10

条目保存在本地 ~/.facebook-marketplace-pp-cli/feedback.jsonl 中。除非设置了 FACEBOOK_MARKET_FEEDBACK_ENDPOINT，且传入了 --send 或设置了 FACEBOOK_MARKET_FEEDBACK_AUTO_SEND=true，否则不会发送 POST 请求。默认情况下，反馈仅保存在本地。

写下让你感到意外的地方，而不是错误报告。简短、具体、单行：这才是会不断累积价值的内容。

输出传递

每个命令都接受 --deliver <sink>。输出会发送到指定目标，同时输出到 stdout，或替代 stdout 输出，这样 Agent 无需手动通过管道传递，就能路由命令结果。支持三种目标：

目标	效果
stdout	默认；仅写入 stdout
file:<path>	将输出原子写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到该 URL（使用 application/json；指定 --compact 时使用 application/x-ndjson）

不支持的协议会被拒绝，并返回说明受支持协议集合的结构化错误。Webhook 失败时会返回非零退出码，并在 stderr 中记录 URL 和 HTTP 状态。

命名配置文件

配置文件是一组已保存的标志值，可在多次调用中重复使用。当定时运行的 Agent 每次都以相同配置调用同一命令时，可使用配置文件——这是 HeyGen 的“Beacon”模式。

facebook-marketplace-pp-cli profile save briefing --json
facebook-marketplace-pp-cli --profile briefing inbox list --fb-api-req-friendly-name example-resource
facebook-marketplace-pp-cli profile list --json
facebook-marketplace-pp-cli profile show briefing
facebook-marketplace-pp-cli profile delete briefing --yes

显式标志始终优先于配置文件中的值；配置文件中的值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置文件，以便执行自省的 Agent 在运行时发现它们。

退出代码

代码	含义
0	成功
2	用法错误（参数不正确）
3	未找到资源
4	需要身份验证
5	API 错误（上游问题）
7	请求频率受限（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 facebook-marketplace-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上方的前置条件
3. 其他任何内容 → 直接使用（作为 CLI 命令执行，并附加 --agent）

安装 MCP 服务

从此 CLI 已发布的公共库条目或预构建版本安装 MCP 二进制文件，然后注册它：

claude mcp add facebook-marketplace-pp-mcp -- facebook-marketplace-pp-mcp

验证：claude mcp list

直接使用

1. 检查是否已安装：which facebook-marketplace-pp-cli 如果未找到，提供安装选项（参见此技能顶部的前置条件）。
2. 根据上方的独特功能和命令参考，选择最符合用户查询的命令。
3. 使用 --agent 标志执行：

   facebook-marketplace-pp-cli <command> [subcommand] [args] --agent
   

4. 如果含义不明确，请查看子命令帮助：facebook-marketplace-pp-cli <command> --help。