青狐视频号 ID 转用户名转换器

安装指南

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

什么是

此 Openclaw Skills 条目可将微信视频号短 ID（例如以 sph 开头的 ID）转换为对应的 v2_...@finder 格式 finder 用户名。它通过 qhkit mcp 命令使用青狐数据的 fetch_channel_id_to_username 工具，因此无需在主机环境中查找或配置 MCP 服务器。
当下游集成需要 finder 用户名，而你手上只有公开频道 ID 时，可以使用此工具。此技能专注于这项转换，不会进行更广泛的账户分析，也不会用无关工具替代转换功能。

应用场景

sph
开头的微信视频号 ID 转换为 finder 用户名。
为需要
v2_...@finder

工作原理

处理“将此视频号 ID 转换为用户名”或“如何查询 sph ID？”等请求。
为兼容的下游工作流程提供经过验证的频道标识符，例如生成视频分享 URL。

工作原理

检查必需的 qhkit CLI 是否已安装并完成配置。
在对话中首次调用付费工具之前，说明该工具、用途及预计的青狐积分费用，并取得用户授权。
对 fetch_channel_id_to_username 运行 qhkit mcp describe，确认当前输入 schema，然后检查单次调用的预估费用。
将用户实际提供的频道 ID 作为必填的 channel_id 参数传入。可选地将 raw 设为 true 以获取原始响应，或设为 false 以获取简化后的解析结果；以当前描述的 schema 为准。
读取单行 JSON 结果，准确转述错误，并在成功时返回转换后的用户名。如适用，报告返回的 credits 字段中的实际扣费。

配置指南

需要 Node.js 18 或更高版本，以及 qhkit 0.14.0 或更高版本才能使用 mcp 命令。全局安装 CLI：
npm i -g @iqinghu/qhkit
如果官方 npm registry 速度缓慢或无法使用，请改用 npm 镜像重试：
npm i -g @iqinghu/qhkit --registry=https://registry.npmmirror.com
配置青狐 API token，然后验证设置：
qhkit config set --token --env prod
qhkit config show
也可以通过 QHKIT_TOKEN 环境变量提供 token。请从青狐工作台获取 token。如果缺少 qhkit，请先安装 Node.js；例如在 macOS 上使用 brew install node。如果 CLI 提示版本过旧或命令 mcp 未知，请使用 npm i -g @iqinghu/qhkit@latest 升级。

数据架构

转换调用接受包含工具名称和参数的 JSON 请求：
Field Type Required Purpose
name string Yes 工具名称：fetch_channel_id_to_username
params.channel_id string Yes 微信视频号短 ID，通常以 sph 开头
params.raw boolean No true 请求原始响应；false 请求简化后的解析结构
qhkit mcp describe 返回的实时 schema 优先于此参考信息。成功时，CLI 会输出单行 JSON 对象，包含 ok、stage、name、credits 和 data；失败时则包含 ok: false、stage 和 message。此转换通常会在 data 中返回简短结果。对于复杂参数或包含引号、中文文本的值，请将完整 JSON 请求放入文件，然后调用 qhkit mcp call @params.json。此技能不定义单独的持久化数据分类体系，也不会生成项目文件。

高级特性

qhkit mcp describe
检查当前工具 schema，并使用
qhkit mcp estimate
在执行前查看调用的积分预估费用。
通过可选的
raw
布尔值支持原始或简化的响应模式。
可通过
qhkit mcp call @params.json
接受 JSON 请求文件，避免 shell 转义问题。
对话中首次付费调用前必须取得用户明确授权；不得调用用户未授权的工具。
根据返回的
credits
值报告实际用量，不得编造价格或换算积分单位。
严格限定用途：如需进行更广泛的微信视频号分析，请使用适当的配套技能或青狐工具，而不要改作他用。

name: qinghu-shipinhao-id-convert description: "青虎AI 视频号-ID转username：把 sph 开头的视频号 ID 转成后续接口需要的 finder username（v2_...@finder）。当用户说「把视频号 ID 转成 username」「sph 开头的号怎么查」或提出同类需求时必须触发。关键词：青虎AI、qhkit、青虎数据、视频号、微信视频号、视频号ID、finder username、ID转换、视频号ID转Username。" user-invocable: true
homepage: https://www.npmjs.com/package/@iqinghu/qhkit