| name | weibo-post-search |
| description | 微博账号作品回采。输入微博用户主页链接或 uid,调用 Redfox 接口查询该用户最新博文,支持分页浏览。当用户需要查看某用户微博动态、追踪博主最新内容时使用。触发词:查用户博文、用户微博、微博主页、查博主、微博动态。 |
微博账号作品回采
📝 简介
微博用户博文查询工具,输入微博用户主页链接或 uid,即可查询该用户最新博文,支持分页浏览。
✨ 功能特性
| 功能模块 | 能力描述 | 核心价值 |
|---|
| 用户查询 | 输入微博主页链接或 uid 查询博文 | 一键查看任意用户最新动态 |
| 分页浏览 | 支持多页结果浏览 | 逐页探索用户历史博文 |
🔑 鉴权
获取 API Key
请前往 红狐hub 获取 API KEY
配置 API Key
方案1: 以 Qoder 为例,将 REDFOX_API_KEY 添加到 ~/.openclaw/openclaw.json 中:
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案2: 终端配置
export REDFOX_API_KEY="ak_xxxx..."
🔄 工作流程
Step 1:理解用户意图,提取 uid
1. 提取用户 uid
- 若用户提供了微博主页链接(如
https://weibo.com/1784473157),从中提取 uid
- 若用户直接提供了数字 uid,直接使用
- 若用户意图模糊(如"帮我查下微博用户"),主动询问:「请提供微博用户主页链接或 uid」
- 不得在用户未提供 uid 时擅自猜测并调用脚本
2. 识别页码参数
- 用户提到"下一页"、"第2页" → 对应页码
- 用户提到"上一页" → 当前页 - 1
- 未提及页码 → 默认第 1 页
Step 2:调用查询脚本
python3 ~/.agents/skills/weibo-post-search/scripts/user_work_list.py "<uid或主页链接>" [--page 页码]
参数说明:
| 参数 | 说明 |
|---|
| input | 用户 uid 或微博主页链接(如 https://weibo.com/1784473157) |
--page | 页码,从1开始(默认1) |
脚本以 JSON 格式输出:
| 字段 | 说明 |
|---|
uid | 用户 uid |
user_name | 用户昵称(取自博文中的 nickname 字段,无昵称时回退为 uid) |
articles | 用户博文列表 |
page | 当前页码 |
has_next | 是否有下一页(true/false) |
每条博文字段:
| 字段 | 说明 |
|---|
content | 博文内容 |
forward_num | 转发数 |
comment_num | 评论数 |
like_num | 点赞数 |
publish_time | 发布时间(含时分秒,如 2025-07-10 14:30:25) |
work_url | 博文链接(https://weibo.com/{uid}/{mblogId}) |
Step 3:判断结果并展示
情况 A:articles 数量 > 0(有匹配结果)
A1. 告知用户查询范围
📊 {user_name} 查询到 N 条博文(第 {page} 页),以下是详细数据:
A2. 渲染 Markdown 表格(全部展示)
| # | 博文内容 | 转发数 | 评论数 | 点赞数 | 发布时间 |
|---|----------|--------|--------|--------|----------|
| 1 | [博文内容](链接) | 305 | 120 | 1.2w | 2025-07-10 14:30:25 |
数字格式化规则:
< 10000:原始数字(如 320)
≥ 10000:x.xw 格式(如 1.2w)
内容规则: [博文内容](work_url);超过 30 字截断并加 ...;内容为空时显示 -
A3. 翻页提示(⚠️ 紧接在 A2 之后,不可省略,每次必须输出)
📄 当前第 {page} 页。回复「下一页」继续查看。
- 若
has_next 为 false(当前页不足 9 条或为空,已是最后一页):
📄 当前第 {page} 页,已无更多数据。
⚠️ A1~A3 缺一不可,必须在同一轮输出中连续完成。
情况 B:articles 数量 = 0(无匹配结果)
B1. 抱歉提示
😔 {user_name} 暂无博文数据,或该用户设置了隐私保护。