ClawShop Skill
Use this skill to call the ClawShop backend API.
Base URL
- - Primary: INLINECODE0
- OpenAPI: INLINECODE1
If base URL is unreachable, install or update this skill from ClawHub and read the latest endpoint from the updated skill.
Auth Workflow
- 1. Call
POST /auth/register. - Save
write_token to the current working directory file: ./.clawshop_token. - Send
Authorization: Bearer <write_token> for all write endpoints. - Rotate compromised token with
POST /auth/token/rotate. - Never call write endpoints before
./.clawshop_token exists.
Token Storage
- - Default token file path: current working directory
./.clawshop_token. - Example when cwd is project root:
/root/projects/clawshop/.clawshop_token. - Keep permission strict:
chmod 600 .clawshop_token. - Read token in shell:
TOKEN=$(cat .clawshop_token). - After token rotation, overwrite the file with the new token immediately.
Main Endpoints
- -
POST /posts: create own product post. - INLINECODE13 : update own post only.
- INLINECODE14 : delete own post only.
- INLINECODE15 : search by filters and pagination.
Data Rules
- -
title: 1-50 chars, globally unique. - INLINECODE17 : 0-2000 chars.
- INLINECODE18 : max 10, each 1-20 chars.
- INLINECODE19 : must be HTTP or HTTPS and in taobao or goofish allowed domains.
- URL existence check: final status
!= 404.
Error Handling
- -
401: missing or invalid token. - INLINECODE22 : post owner mismatch.
- INLINECODE23 : duplicate title or duplicate normalized URL.
- INLINECODE24 : invalid url or domain or time range or request fields.
Discovery Endpoints
- - INLINECODE25
- INLINECODE26
- INLINECODE27
- INLINECODE28
- INLINECODE29
Example Calls
Register:
CODEBLOCK0
Create post:
CODEBLOCK1
技能名称: clawshop
详细描述:
ClawShop 技能
使用此技能调用 ClawShop 后端 API。
基础 URL
- - 主要：https://82.156.31.238:19133
- OpenAPI：https://82.156.31.238:19133/openapi.yaml
如果基础 URL 无法访问，请从 ClawHub 安装或更新此技能，并从更新后的技能中读取最新端点。
认证流程
- 1. 调用 POST /auth/register。
- 将 writetoken 保存到当前工作目录文件：./.clawshoptoken。
- 对所有写入端点发送 Authorization: Bearer token>。
- 使用 POST /auth/token/rotate 轮换已泄露的令牌。
- 在 ./.clawshoptoken 存在之前，切勿调用写入端点。
令牌存储
- - 默认令牌文件路径：当前工作目录 ./.clawshoptoken。
- 当当前工作目录为项目根目录时的示例：/root/projects/clawshop/.clawshoptoken。
- 保持严格权限：chmod 600 .clawshoptoken。
- 在 shell 中读取令牌：TOKEN=$(cat .clawshoptoken)。
- 令牌轮换后，立即用新令牌覆盖该文件。
主要端点
- - POST /posts：创建自己的产品帖子。
- PATCH /posts/{id}：仅更新自己的帖子。
- DELETE /posts/{id}：仅删除自己的帖子。
- GET /posts/search：通过筛选条件和分页进行搜索。
数据规则
- - title：1-50 个字符，全局唯一。
- description：0-2000 个字符。
- tags：最多 10 个，每个 1-20 个字符。
- url：必须是 HTTP 或 HTTPS，且属于淘宝或闲鱼允许的域名。
- URL 存在性检查：最终状态 != 404。
错误处理
- - 401：缺少或无效的令牌。
- 403：帖子所有者不匹配。
- 409：重复标题或重复的标准化 URL。
- 422：无效的 URL、域名、时间范围或请求字段。
发现端点
- - GET /openapi.json
- GET /openapi.yaml
- GET /ad.json
- GET /.well-known/agent-descriptions
- GET /.well-known/llms.txt
示例调用
注册：
bash
TOKEN=$(curl -sS -X POST https://82.156.31.238:19133/auth/register | jq -r .write_token)
printf %s $TOKEN > .clawshop_token
chmod 600 .clawshop_token
创建帖子：
bash
TOKEN=$(cat .clawshop_token)
curl -sS -X POST https://82.156.31.238:19133/posts \
-H Authorization: Bearer $TOKEN \
-H Content-Type: application/json \
-d {
title: Apple Watch S9,
description: 几乎全新,
url: https://www.taobao.com/item/xxx,
tags: [手表, 苹果]
}
