Pp Facebook Marketplace

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/facebook-marketplace/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Facebook Marketplace — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the facebook-marketplace-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

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

2. Verify: facebook-marketplace-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

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

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Use this CLI for local, human-paced Facebook Marketplace workflows: searching, watching, triaging matches, drafting listings, and replying to seller inbox threads after explicit approval. Avoid using it for bulk automation or cross-platform scraping.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Seller workflow

• draft — Draft a Marketplace title, description, and price suggestion from photos and notes.

  Use this when preparing a seller listing before opening a write-gated post flow.

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

• reply — Prepare and send a seller inbox reply only when --write and doctor gating both pass.

  Use this only for human-approved sell-side messaging.

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

Buy-side workflow

• watch add — Persist a Marketplace search watch with deterministic keyword, price, and distance filters.

  Use this when the agent needs to monitor Marketplace without deciding relevance on every raw result.

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

• matches — Show new watch matches after deterministic filtering.

  Use this when an agent needs the shortlist worth showing a human buyer.

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

Local mirror

• stale — Find local seller listings older than seven days with no engagement.

  Use this when deciding which seller listings need price changes or renewal.

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

HTTP Transport

This CLI uses Chrome-compatible HTTP transport over HTTP/3 for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Command Reference

composer — Sell-side composer helper operations.

• facebook-marketplace-pp-cli composer price_prediction — Fetch Marketplace composer price prediction.
• facebook-marketplace-pp-cli composer root — Fetch Marketplace listing composer metadata.
• facebook-marketplace-pp-cli composer shipping_options — Fetch calculated shipping options for a draft listing.

inbox — Marketplace inbox and messaging operations.

• facebook-marketplace-pp-cli inbox list — Fetch Marketplace inbox overview.
• facebook-marketplace-pp-cli inbox thread — Fetch a direct Marketplace/Messenger thread by thread id.
• facebook-marketplace-pp-cli inbox message_seller — Send a Marketplace seller message.
• facebook-marketplace-pp-cli inbox seller_threads — Fetch Marketplace seller inbox threads.
• facebook-marketplace-pp-cli inbox seller_threads_page — Fetch a page of Marketplace seller inbox threads.

listing — Listing detail and sell-side listing operations.

• facebook-marketplace-pp-cli listing change_availability — Change a Marketplace listing availability state.
• facebook-marketplace-pp-cli listing create — Create a Marketplace listing from a prepared composer payload; pass --photo to upload local photos first.
• facebook-marketplace-pp-cli listing delete — Delete a Marketplace for-sale item.
• facebook-marketplace-pp-cli listing get — Fetch a Marketplace listing detail page payload.
• facebook-marketplace-pp-cli listing media — Fetch Marketplace listing media payload.
• facebook-marketplace-pp-cli listing upload-photo — Upload a local photo and return the Marketplace composer photo_id.

marketplace — Marketplace browse and location operations.

• facebook-marketplace-pp-cli marketplace browse_feed — Fetch Marketplace browse feed results.
• facebook-marketplace-pp-cli marketplace set_browse_radius — Set Marketplace browse radius.
• facebook-marketplace-pp-cli marketplace set_buy_location — Set Marketplace buying location.

marketplace_search — Marketplace search operations.

• facebook-marketplace-pp-cli marketplace_search — Search Marketplace listings.

Hand-written commands

• facebook-marketplace-pp-cli draft — AI listing drafter from photos and notes.
• facebook-marketplace-pp-cli watch — Buy-side deterministic watcher commands.
• facebook-marketplace-pp-cli matches — Show watcher matches after deterministic filtering.
• facebook-marketplace-pp-cli stale — Show local listings older than seven days with no engagement.
• facebook-marketplace-pp-cli reply — Write-gated sell-side message reply helper.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

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

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Create a buy-side watch

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

Stores deterministic filter criteria locally so future runs can compare new listings.

Read a direct Marketplace buyer thread

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

Reads the real Messenger thread route for a known Marketplace thread id and returns parsed summary plus message text, sender ids, and timestamps.