pp-craigslist

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Craigslist — Printing Press CLI

Craigslist — Printing Press CLI

Prerequisites: Install the CLI

前提条件:安装CLI

This skill drives the
craigslist-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:
    bash
    npx -y @mvanhorn/printing-press install craigslist --cli-only
  2. Verify:
    craigslist-pp-cli --version
  3. Ensure
    $GOPATH/bin
    (or
    $HOME/go/bin
    ) is on
    $PATH
    .
If the
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):
bash
go install github.com/mvanhorn/printing-press-library/library/commerce/craigslist/cmd/craigslist-pp-cli@latest
If
--version
reports "command not found" after install, the install step did not put the binary on
$PATH
. Do not proceed with skill commands until verification succeeds.
本技能基于
craigslist-pp-cli
二进制文件运行。在调用本技能的任何命令之前,您必须确认CLI已安装。 如果未安装,请先执行以下步骤:
  1. 通过Printing Press安装器安装:
    bash
    npx -y @mvanhorn/printing-press install craigslist --cli-only
  2. 验证安装:
    craigslist-pp-cli --version
  3. 确保
    $GOPATH/bin
    (或
    $HOME/go/bin
    )已添加到
    $PATH
    环境变量中。
如果
npx
安装失败(如无Node环境、离线等),可改用Go直接安装(要求Go 1.23+版本):
bash
go install github.com/mvanhorn/printing-press-library/library/commerce/craigslist/cmd/craigslist-pp-cli@latest
如果安装后执行
--version
提示"command not found",说明安装步骤未将二进制文件添加到
$PATH
中。请在验证成功前不要执行本技能的命令。

When to Use This CLI

何时使用此CLI

Use craigslist-pp-cli when you need scriptable, local-first access to Craigslist listings — searching with filters Craigslist's own UI doesn't support (NOT-keyword), watching saved searches across multiple cities and getting alerted only on true new listings, doing price-drift or repost detection on housing, and triaging suspect rentals against cross-city duplicate signals. Best for read-heavy workflows: watching, exporting, comparing, scoring. Posting and account management are out of scope.
当您需要通过脚本实现本地优先的Craigslist信息访问时,可使用craigslist-pp-cli——它支持Craigslist原生UI不具备的过滤条件(NOT关键字)、跨城市监控已保存的搜索并仅针对真正的新信息发出提醒、检测房源的价格变动或重复发布情况,以及通过跨城市重复信号分类可疑租房信息。最适合以读取为主的工作流:监控、导出、对比、评分。发布信息和账户管理不在本工具的范围内。

When Not to Use This CLI

何时不使用此CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.
请勿使用此CLI执行需要创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或修改远程状态的请求。本CLI仅提供用于查看、导出、同步和分析的只读命令。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.
这些功能是其他同类API工具所不具备的。

Compounding watch surface

复合监控范围

  • watch run
    — Periodic poll for a saved search that emits NEW, PRICE-DROP, and SEED events instead of any-listing-I-haven't-seen — so true new listings stand out from edits and reposts. Cross-city repost detection lives in the separate
    reposts
    command; cross-city dup detection lives in
    dupe-cluster
    .
    Pick this over a generic search call when an agent is alerting a user — only true-new listings are worth pinging on, and the typed diff event tells the agent how to phrase the alert.
    bash
    craigslist-pp-cli watch save apartments --query 1BR --negate furnished,sublet --sites sfbay --category apa --max-price 2500 && craigslist-pp-cli watch run apartments --seed-only && craigslist-pp-cli watch run apartments --json
  • watch tail
    — Long-running tail that prints one JSON event per new diff result so an agent or shell pipeline can react in real time. Emits NEW and PRICE-DROP events.
    When you want a continuous stream of new-listing events to pipe into a Slack/email sender, jq filter, or downstream agent loop.
    bash
    craigslist-pp-cli watch tail apartments --interval 5m --json
  • watch run
    — 定期轮询已保存的搜索,仅发出NEW(新信息)、PRICE-DROP(降价)和SEED(初始数据)事件,而非所有未见过的信息——这样真正的新信息会从编辑和重复发布的信息中脱颖而出。跨城市重复发布检测功能在单独的
    reposts
    命令中;跨城市重复信息检测在
    dupe-cluster
    命令中。
    当Agent需要向用户发送提醒时,请选择此命令——只有真正的新信息值得推送,且类型化的差异事件会告知Agent如何组织提醒话术。
    bash
    craigslist-pp-cli watch save apartments --query 1BR --negate furnished,sublet --sites sfbay --category apa --max-price 2500 && craigslist-pp-cli watch run apartments --seed-only && craigslist-pp-cli watch run apartments --json
  • watch tail
    — 长期运行的实时监控命令,每产生一个新的差异结果就输出一条JSON事件,以便Agent或Shell管道实时做出响应。仅发出NEW和PRICE-DROP事件。
    当您需要持续获取新信息事件流,并将其传输到Slack/邮件发送器、jq过滤器或下游Agent循环时使用。
    bash
    craigslist-pp-cli watch tail apartments --interval 5m --json

Local snapshot history

本地快照历史

  • drift
    — Show the price timeline for a single listing across every snapshot we've captured.
    Agents negotiating on behalf of a buyer can quote concrete price-drop history — "this listing was $50, now $35, posted 14 days ago."
    bash
    craigslist-pp-cli drift 7915891289 --json
  • dupe-cluster
    — Find listings whose body fingerprint and image hash match across cities. Surfaces cross-city scams and aggregator reposts.
    Use before driving across town to view a rental — a cluster of 6+ cities for one apartment is almost always a scam.
    bash
    craigslist-pp-cli dupe-cluster --category apa --min-cluster-size 3 --json
  • reposts
    — Find listings that have been reposted N or more times in the last X days, by body fingerprint clustering.
    Reposts signal motivated sellers (negotiation leverage) or spam flooders (skip). Telling them apart is the value.
    bash
    craigslist-pp-cli reposts 'eames lounge' --min-reposts 3 --window 30d --json
  • cities heat
    — Across cities, count fresh listings per category over a window. Surfaces which markets are hot for what.
    When an agent is hunting cross-city for a specific item, knowing which 3 cities have the most fresh activity tells it where to look first.
    bash
    craigslist-pp-cli cities heat --category sss --since 24h --top 20 --json
  • drift
    — 展示单个信息在我们捕获的所有快照中的价格时间线。
    Agent代表买家谈判时,可以引用具体的降价历史——比如"这条信息最初标价50美元,现在35美元,已发布14天"。
    bash
    craigslist-pp-cli drift 7915891289 --json
  • dupe-cluster
    — 查找正文指纹和图片哈希在多个城市匹配的信息,揭露跨城市诈骗和聚合平台重复发布的信息。
    在驱车前往看房前使用此命令——同一房源在6个及以上城市出现几乎肯定是诈骗。
    bash
    craigslist-pp-cli dupe-cluster --category apa --min-cluster-size 3 --json
  • reposts
    — 通过正文指纹聚类,查找在过去X天内重复发布N次及以上的信息。
    重复发布意味着卖家急于出手(谈判筹码)或垃圾信息泛滥(需跳过)。区分两者正是本功能的价值所在。
    bash
    craigslist-pp-cli reposts 'eames lounge' --min-reposts 3 --window 30d --json
  • cities heat
    — 统计一段时间内各城市各分类下的最新信息数量,展现哪些市场在哪些领域较为活跃。
    当Agent跨城市寻找特定物品时,了解哪3个城市的最新活动最多,就能知道优先去哪里搜索。
    bash
    craigslist-pp-cli cities heat --category sss --since 24h --top 20 --json

Triage and scoring

分类与评分

  • scam-score
    — Rule-based 0-100 score for a listing using brand-new-account, below-median-price, wire-transfer keywords, and cross-city duplicate signals.
    Agents triaging "is this listing legit" questions get an actionable number plus the per-rule contributions, instead of a vibes-based answer.
    bash
    craigslist-pp-cli scam-score 7915891289 --json
  • median
    — p25/p50/p75 of prices for a query, optionally over a time window or split by city.
    When an agent needs a fair-price benchmark before suggesting an offer, or when a reseller is sizing up a market.
    bash
    craigslist-pp-cli median 'iphone 15' --category mob --since 30d --by-city --json
  • scam-score
    — 基于规则为信息给出0-100的诈骗评分,参考因素包括全新账户、低于中位数价格、电汇关键词以及跨城市重复信号。
    Agent在处理"这条信息是否合法"的问题时,会得到一个可操作的分数以及各规则的贡献值,而非仅凭直觉判断。
    bash
    craigslist-pp-cli scam-score 7915891289 --json
  • median
    — 查询结果的p25/p50/p75价格分位数,可按时间范围或城市拆分。
    当Agent需要一个合理的价格基准来建议报价,或者卖家想要评估市场情况时使用。
    bash
    craigslist-pp-cli median 'iphone 15' --category mob --since 30d --by-city --json

Search beyond CL

超越Craigslist原生搜索

  • search --negate
    — Search with NOT-keyword filtering that Craigslist's own search doesn't support natively.
    Apartment-hunting and job-search personas live and die by exclusion terms; this is the difference between scanning 50 results and scanning 5.
    bash
    craigslist-pp-cli search '1BR' --category apa --site sfbay --negate furnished,sublet,studio --json
  • since
    — Ad-hoc "what's new in this category in this city since X duration ago" without setting up a saved search.
    The first command an agent should run for "what hit while I was sleeping" — no per-watch setup, no state, just a window.
    bash
    craigslist-pp-cli since 24h --site sfbay --category sss --query ipad --json
  • search --negate
    — 支持NOT关键字过滤,这是Craigslist原生搜索不具备的功能。
    找房和找工作的用户非常依赖排除项;有了这个功能,您只需浏览5条结果,而非50条。
    bash
    craigslist-pp-cli search '1BR' --category apa --site sfbay --negate furnished,sublet,studio --json
  • since
    — 无需设置保存的搜索,即可临时查询"自X时间段以来,某城市某分类下的新信息"。
    这是Agent处理"我睡觉期间有什么新信息"问题时应运行的第一个命令——无需设置监控,无需状态,只需指定时间范围。
    bash
    craigslist-pp-cli since 24h --site sfbay --category sss --query ipad --json

Command Reference

命令参考

The full command tree is discoverable via
craigslist-pp-cli --help
and recursively via
craigslist-pp-cli <command> --help
. Headline groups:
  • Reference taxonomy:
    categories list
    ,
    areas list
    ,
    catalog refresh
  • Search & fetch:
    search
    ,
    postings
    ,
    listing get|get-by-pid|images
    ,
    filters show
  • Local store population:
    cl-sync
  • Saved-search watches:
    watch save|list|show|delete|run|tail
  • Snapshot analytics:
    drift
    ,
    dupe-cluster
    ,
    reposts
    ,
    median
    ,
    cities heat
    ,
    since
    ,
    geo within|bbox
  • Triage:
    scam-score
  • Local-state CRUD:
    favorite add|list|remove
  • Framework helpers:
    doctor
    ,
    version
    ,
    which
    ,
    agent-context
    ,
    analytics
    ,
    export
    ,
    import
    ,
    feedback
    ,
    profile
    ,
    tail
    ,
    sync
    ,
    workflow
完整的命令树可通过
craigslist-pp-cli --help
查看,也可通过
craigslist-pp-cli <command> --help
递归查看子命令。主要命令组:
  • 参考分类
    categories list
    ,
    areas list
    ,
    catalog refresh
  • 搜索与获取
    search
    ,
    postings
    ,
    listing get|get-by-pid|images
    ,
    filters show
  • 本地存储填充
    cl-sync
  • 已保存搜索监控
    watch save|list|show|delete|run|tail
  • 快照分析
    drift
    ,
    dupe-cluster
    ,
    reposts
    ,
    median
    ,
    cities heat
    ,
    since
    ,
    geo within|bbox
  • 分类处理
    scam-score
  • 本地状态增删改查
    favorite add|list|remove
  • 框架辅助工具
    doctor
    ,
    version
    ,
    which
    ,
    agent-context
    ,
    analytics
    ,
    export
    ,
    import
    ,
    feedback
    ,
    profile
    ,
    tail
    ,
    sync
    ,
    workflow

Freshness Contract

新鲜度约定

This printed CLI owns bounded freshness only for registered store-backed read command paths. In
--data-source auto
mode, those paths check
sync_state
and may run a bounded refresh before reading local data.
--data-source local
never refreshes.
--data-source live
reads the API and does not mutate the local store. Set
CRAIGSLIST_NO_AUTO_REFRESH=1
to skip the freshness hook without changing source selection.
Covered paths:
  • craigslist-pp-cli postings
When JSON output uses the generated provenance envelope, freshness metadata appears at
meta.freshness
. Treat it as current-cache freshness for the covered command path, not a guarantee of complete historical backfill or API-specific enrichment.
本CLI仅对已注册的基于存储的只读命令路径保证有限的新鲜度。在
--data-source auto
模式下,这些路径会检查
sync_state
,并可能在读取本地数据前进行有限的刷新。
--data-source local
模式从不刷新数据。
--data-source live
模式直接读取API,且不修改本地存储。设置
CRAIGSLIST_NO_AUTO_REFRESH=1
可跳过新鲜度检查,无需更改数据源选择。
覆盖的命令路径:
  • craigslist-pp-cli postings
当JSON输出使用生成的来源信封时,新鲜度元数据会显示在
meta.freshness
字段中。将其视为对应命令路径的当前缓存新鲜度,而非完整历史回填或API特定增强的保证。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
craigslist-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.
当您知道要做什么但不知道用哪个命令时,可直接询问CLI:
bash
craigslist-pp-cli which "<用您自己的话描述功能>"
which
命令会将自然语言的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少有一个匹配项;退出码
2
表示没有确定的匹配项——此时可使用
--help
或更精确的查询。

Recipes

使用示例

Hunt one item across the western US

在美国西部搜索某物品

bash
craigslist-pp-cli search 'eames lounge chair' --sites sfbay,losangeles,seattle,sandiego,sacramento,fresno,inlandempire,orangecounty --category fua --max-price 2500 --has-pic --json --select items.title,items.priceDisplay,items.site,items.canonicalUrl
Fans out across 8 west-coast sites in parallel and narrows the JSON to the shape an agent or jq pipeline needs.
bash
craigslist-pp-cli search 'eames lounge chair' --sites sfbay,losangeles,seattle,sandiego,sacramento,fresno,inlandempire,orangecounty --category fua --max-price 2500 --has-pic --json --select items.title,items.priceDisplay,items.site,items.canonicalUrl
并行覆盖8个西海岸站点,并将JSON结果精简为Agent或jq管道所需的格式。

Watch for a 1BR that isn't furnished or a sublet

监控非家具齐全且非转租的一居室

bash
craigslist-pp-cli watch save sf-1br --query '1BR' --sites sfbay --category apa --max-price 2800 --negate furnished,sublet,studio,airbnb && craigslist-pp-cli watch run sf-1br --seed-only && craigslist-pp-cli watch tail sf-1br --interval 5m --json
Saved search uses negative keywords Craigslist itself doesn't support; the seed-only run primes
seen_listings
so the next tail cycle emits only true new listings as
[NEW]
and
[PRICE-DROP]
events.
bash
craigslist-pp-cli watch save sf-1br --query '1BR' --sites sfbay --category apa --max-price 2800 --negate furnished,sublet,studio,airbnb && craigslist-pp-cli watch run sf-1br --seed-only && craigslist-pp-cli watch tail sf-1br --interval 5m --json
已保存的搜索使用Craigslist原生不支持的否定关键字;仅初始数据运行会填充
seen_listings
,这样后续的实时监控循环只会发出
[NEW]
[PRICE-DROP]
事件,对应真正的新信息。

Triage a too-good listing

分类看起来过于诱人的信息

bash
craigslist-pp-cli cl-sync --site sfbay --category apa --since 7d && craigslist-pp-cli scam-score 7915891289 --json && craigslist-pp-cli dupe-cluster --pid 7915891289 --json
cl-sync
populates the local store; score returns the per-rule contributions; dupe-cluster shows whether the same listing exists in other cities. Both downstream commands need the store populated to return useful data.
bash
craigslist-pp-cli cl-sync --site sfbay --category apa --since 7d && craigslist-pp-cli scam-score 7915891289 --json && craigslist-pp-cli dupe-cluster --pid 7915891289 --json
cl-sync
填充本地存储;评分命令返回各规则的贡献值;重复信息聚类命令显示该信息是否在其他城市存在。这两个下游命令都需要本地存储填充才能返回有用数据。

Quote a fair-price range

查询合理价格范围

bash
craigslist-pp-cli median 'iphone 15' --category mob --since 30d --by-city --json
p25/p50/p75 over the last 30 days, split by city, computed from the local listing_snapshot table.
bash
craigslist-pp-cli median 'iphone 15' --category mob --since 30d --by-city --json
基于本地
listing_snapshot
表计算过去30天内按城市拆分的p25/p50/p75价格分位数。

What hit while I was asleep

查看我睡觉期间的新信息

bash
craigslist-pp-cli since 12h --site sfbay --category sss --query 'macbook pro' --json
Reads sitemap-by-date for the target window, fetches detail only for listings not already in the local store, emits the diff.
bash
craigslist-pp-cli since 12h --site sfbay --category sss --query 'macbook pro' --json
读取目标时间范围内的日期站点地图,仅获取本地存储中没有的信息详情,并输出差异结果。

Auth Setup

认证设置

No authentication required.
Run
craigslist-pp-cli doctor
to verify setup.
无需认证。
运行
craigslist-pp-cli doctor
验证设置是否正确。

Agent Mode

Agent模式

Add
--agent
to any command. Expands to:
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    craigslist-pp-cli postings --agent --select id,name,status
  • Previewable
    --dry-run
    shows the request without sending
  • Offline-friendly — sync/search commands can use the local SQLite store when available
  • Non-interactive — never prompts, every input is a flag
  • Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests
在任何命令后添加
--agent
参数,等效于:
--json --compact --no-input --no-color --yes
  • 可管道传输 — JSON输出到标准输出,错误信息输出到标准错误
  • 可过滤
    --select
    参数保留指定字段。点路径可深入嵌套结构;数组可遍历元素。对于冗长的API,这是缩小上下文范围的关键:
    bash
    craigslist-pp-cli postings --agent --select id,name,status
  • 可预览
    --dry-run
    参数显示请求内容但不发送
  • 离线友好 — 同步/搜索命令在可用时可使用本地SQLite存储
  • 非交互式 — 从不提示,所有输入均通过标志参数提供
  • 只读 — 请勿使用此CLI执行创建、更新、删除、发布、评论、点赞、邀请、下单、发送或其他修改状态的请求

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
Parse
.results
for data and
.meta.source
to know whether it's live or local. A human-readable
N results (live)
summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包裹在来源信封中:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
字段获取数据,
.meta.source
字段表示数据来自实时API还是本地存储。仅当标准输出为终端时,才会向标准错误输出人类可读的
N results (live)
摘要——管道传输或Agent消费者只会在标准输出得到纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
craigslist-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
craigslist-pp-cli feedback --stdin < notes.txt
craigslist-pp-cli feedback list --json --limit 10
Entries are stored locally at
~/.craigslist-pp-cli/feedback.jsonl
. They are never POSTed unless
CRAIGSLIST_FEEDBACK_ENDPOINT
is set AND either
--send
is passed or
CRAIGSLIST_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当您(或Agent)发现此CLI存在问题时,可记录反馈:
craigslist-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
craigslist-pp-cli feedback --stdin < notes.txt
craigslist-pp-cli feedback list --json --limit 10
反馈条目会本地存储在
~/.craigslist-pp-cli/feedback.jsonl
中。只有当设置了
CRAIGSLIST_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置了
CRAIGSLIST_FEEDBACK_AUTO_SEND=true
时,反馈才会被发送。默认行为仅本地存储。
请写下让您感到意外的内容,而非正式的错误报告。简短、具体、一句话即可——这样的反馈最有价值。

Output Delivery

输出交付

Every command accepts
--deliver <sink>
. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or
application/x-ndjson
when
--compact
)
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都支持
--deliver <sink>
参数。输出会发送到指定的接收端,同时(或替代)标准输出,以便Agent无需手动管道即可路由命令结果。支持三种接收端:
接收端效果
stdout
默认;仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
(先写入临时文件再重命名)
webhook:<url>
将输出正文POST到指定URL(当使用
--compact
时为
application/json
application/x-ndjson
格式)
未知的协议会被拒绝,并返回包含支持协议列表的结构化错误。Webhook失败会返回非零退出码,并在标准错误输出URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
craigslist-pp-cli profile save briefing --json
craigslist-pp-cli --profile briefing postings
craigslist-pp-cli profile list --json
craigslist-pp-cli profile show briefing
craigslist-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults.
agent-context
lists all available profiles under
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的标志值,可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时,可使用此功能——即HeyGen的"Beacon"模式。
craigslist-pp-cli profile save briefing --json
craigslist-pp-cli --profile briefing postings
craigslist-pp-cli profile list --json
craigslist-pp-cli profile show briefing
craigslist-pp-cli profile delete briefing --yes
显式标志始终优先于配置文件值;配置文件值优先于默认值。
agent-context
命令会在
available_profiles
字段下列出所有可用配置文件,以便Agent在运行时发现它们。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误(参数错误)
3资源未找到
5API错误(上游问题)
7速率限制(请等待后重试)
10配置错误

Argument Parsing

参数解析

Parse
$ARGUMENTS
:
  1. Empty,
    help
    , or
    --help
    → show
    craigslist-pp-cli --help
    output
  2. Starts with
    install
    → ends with
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with
    --agent
    )
解析
$ARGUMENTS
的规则:
  1. 为空、
    help
    --help
    → 显示
    craigslist-pp-cli --help
    输出
  2. install
    开头
    → 若结尾为
    mcp
    → 安装MCP;否则 → 参考顶部的前提条件部分
  3. 其他情况 → 直接使用(添加
    --agent
    参数执行CLI命令)

MCP Server Installation

MCP服务器安装

  1. Install the MCP server:
    bash
    go install github.com/mvanhorn/printing-press-library/library/commerce/craigslist/cmd/craigslist-pp-mcp@latest
  2. Register with Claude Code:
    bash
    claude mcp add craigslist-pp-mcp -- craigslist-pp-mcp
  3. Verify:
    claude mcp list
  1. 安装MCP服务器:
    bash
    go install github.com/mvanhorn/printing-press-library/library/commerce/craigslist/cmd/craigslist-pp-mcp@latest
  2. 在Claude Code中注册:
    bash
    claude mcp add craigslist-pp-mcp -- craigslist-pp-mcp
  3. 验证:
    claude mcp list

Direct Use

直接使用

  1. Check if installed:
    which craigslist-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the
    --agent
    flag:
    bash
    craigslist-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help:
    craigslist-pp-cli <command> --help
    .
  1. 检查是否已安装:
    which craigslist-pp-cli
    若未找到,提供安装选项(参考顶部的前提条件部分)。
  2. 将用户查询与上述独特功能和命令参考中最匹配的命令对应。
  3. 添加
    --agent
    参数执行命令:
    bash
    craigslist-pp-cli <command> [subcommand] [args] --agent
  4. 若存在歧义,查看子命令帮助:
    craigslist-pp-cli <command> --help