品氪 CRM API Skill

触发场景

• AI 模型需要调取品氪后台接口（包括会员相关功能等），通过 Python CLI 完成。
• 需要统一的登录、Token 管理、接口调用和错误处理能力。

功能说明

根据用户问句自动识别意图并调用对应接口，支持以下功能模块：

1. 会员管理：查询会员列表、查询会员详情。

核心能力

• 登录认证：POST https://crm.pinkr.com/Crm/Business/getToken
• Token 管理：内存级缓存，单次运行期间有效
• API 调用：POST+JSON 请求体，Bearer Token 认证
• 错误处理：Token 失效自动重新登录，网络错误自动重试
• 输出：美化 JSON，便于 AI 模型解析

登录认证

• 地址：https://crm.pinkr.com/Crm/Business/getToken
• 方法：POST
• 参数：admin_name，password
• 返回：包含 token 的 JSON（如：{"code": 200, "data": {"token": "xxx"}, "message": "success"}）
• Token 有效期：1 天（内存缓存，单次运行有效）

数据请求格式

所有接口使用统一的 POST 表单方式提交：

• 路径：Crm/Customer/GetCustomers
• 完整 URL：https://crm.pinkr.com/Crm/Customer/GetCustomers
• 方法：POST
• 请求体：{"phone": "13800138000"}
• 响应示例：

公共响应参数

功能概览

| 会员详情 | Crm/Customer/GetCustomer | 会员详情，通过会员列表返回的 customer_id 访问 |

接口说明

1. 会员列表

• 功能：会员列表
• 接口名称：Crm/Customer/GetCustomers
• 请求参数：无
• 返回数据：

1. 会员详情

• 功能：会员详情
• 接口名称：Crm/Customer/GetCustomer
• 请求参数：无
• 返回数据：

使用方法

• 环境变量（推荐）
• PINKR_BASE_URL、PINKR_ADMIN_NAME、PINKR_PASSWORD

命令行接口概览

• login: 登录并缓存 Token 在内存
• api: 调用 API，需提供 --endpoint 与 --data
• clear-cache: 清除内存中的 Token
• test-connection: 测试登录与连接
• show-config: 显示当前配置