安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install listingsapi
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 listingsapi。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

ListingsAPI 是一份 Openclaw Skills 工作流程指南，用于通过托管的 ListingsAPI MCP 服务器 https://listingsapi.com/mcp 进行操作。它可帮助 AI 代理识别已连接的账户及其地点、查询当前端点契约，并获取受支持的目录列表和本地营销信息。
此技能提供的是说明，而非可执行代码或 MCP 客户端。它不会安装或启动服务器。除非用户请求写入操作并批准拟议操作，否则读取操作始终为只读。生产环境通常需要付费套餐；供应有限的 Day Pass 仅限沙盒数据和功能。

应用场景

识别已连接的 ListingsAPI 账户并查找所需的商家地点。
在已连接的 MCP 工具支持时，检查高级目录列表、评论、发布方分析或账户用量。
在准备操作前检查当前文档和端点契约。
起草评论回复或帖子，展示其目标和拟议文本，并在发布前请求批准。
在开放申请时使用 Day Pass 探索 ListingsAPI，且仅使用其沙盒地点和允许的功能。
在获授权的示例地点写入后，确认沙盒目录列表状态和 URL。

工作原理

确认运行环境已通过 Streamable HTTP 连接到 MCP https://listingsapi.com/mcp。如果没有连接，请说明此项前提；不要捏造客户端配置或安装桥接程序。
如果客户端提供 OAuth 浏览器流程，则通过该流程进行身份验证，并从读取权限开始。或者，通过受支持的环境变量使用用户现有的 API 密钥，且不得泄露该密钥。
调用 whoami 确认已连接的账户，然后使用 locations_all 或 locations_search 查找所需地点。
使用 search_docs、get_doc 或 get_endpoint 查询当前操作契约，并在相关时检查 get_usage。
获取所需且受支持的目录列表、评论或分析信息。对于写入操作，先核实目标和契约，在适用时展示拟议内容，并事先取得用户批准。
回读操作结果。将已接受的异步请求视为待处理，而非实时目录列表的证明；遵循服务的重试指引，不要盲目重复写入。

配置指南

此技能不会安装 MCP 客户端、运行本地服务器，也不包含可执行代码。使用前，请将支持 MCP 的运行环境连接到托管端点：

在现有客户端中配置 MCP 连接：

https://listingsapi.com/mcp
如果客户端支持，优先使用 OAuth 用户登录和授权。对于用户已有的自主管理 API 密钥，请通过运行环境的密钥或环境变量机制提供，变量名为 LISTINGSAPI_API_KEY；切勿将密钥放入技能内容、生成的源代码、日志或聊天中。OAuth bearer token 用于 MCP 端点，而 REST 请求使用 API 密钥前缀。
对于 Day Pass，请先在 https://listingsapi.com/api/day-pass 检查实时可用情况，并查看 https://listingsapi.com/docs/day-pass.md。仅在开放申请时才提供注册。注册和激活需要用户授权，且与此技能的设置彼此独立。

数据架构

此技能不定义本地文件格式、不生成数据文件，也不维护自己的元数据分类体系。它操作的是外部 ListingsAPI 服务所持有、并通过已连接的 MCP 工具访问的数据。
数据或操作 技能中所述的处理方式
账户 使用 whoami 确认身份。
地点 使用 locations_all 或 locations_search 发现地点；按地点发起请求前先确认目标。
目录列表和评论 通过 listings_premium 和 reviews_list 等受支持工具获取；先确认当前契约。
发布方分析和用量 仅在受支持且相关时读取；可使用 get_usage 检查用量。
文档和契约 使用 search_docs、get_doc 和 get_endpoint 查询；不要假设每个 REST 操作都有对应的 MCP 功能。
Day Pass 沙盒 最多仅限 2 个沙盒地点，并在激活后 24 小时内同步到 10 个演示目录。不会写入真实发布方，并且不包含评论、帖子、社交、分析、已连接账户和 Webhook。
MCP 不提供归档和删除操作。此技能本身不存储凭据；API 密钥必须由用户自行管理并妥善保护。

高级特性

如果 MCP 客户端提供，OAuth 支持动态客户端注册和 PKCE；不需要预先签发的客户端密钥。遵循最小权限原则，除非任务需要写入，否则从
read
权限开始。
支持通过
LISTINGSAPI_API_KEY
使用用户自主管理的 API 密钥作为替代方案，并设有明确的凭据泄露防护措施。
使用实时文档和端点查询工具核实当前服务契约，而非假设 REST 与 MCP 功能完全一致。
对生产环境写入设置审批关卡：确认目标、检查契约、展示拟议的评论回复或帖子，并在发布前取得用户批准。
谨慎处理异步操作：回读结果，不将请求被接受等同于目录列表已上线。
将 Day Pass 活动与生产环境分开：沙盒写入前必须核实当前有效的 Day Pass 连接，并且仅限用户请求的示例地点和演示目录检查。
读取请求保持只读，并遵循服务的重试指引，不盲目重试写入。

name: listingsapi description: Use the hosted ListingsAPI MCP server to inspect business locations, publisher listings, reviews, posts, and local analytics, or help a user try its Day Pass sandbox. Use the existing listingsapi-integration skill for adding the REST API to an application.