# Weibo Skill API

> 微博技能集合。包含热搜榜、智搜、用户微博、超话互动、图片/视频上传、定时任务、创作者数据分析等功能。 首次使用请先完成配置（向用户询问 App ID 和 App Secret，写入本地配置文件并获取 Token）。

- Skill: `wecode-ai/weibo-skill-api` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add wecode-ai/weibo-skill-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wecode-ai/weibo-skill-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: wecode-ai (https://skillmd.com/u/wecode-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wecode-ai/weibo-skill-api

---


# 微博 Skill

> ⚠️ **执行前必读**：在执行任何功能之前，必须先阅读"功能目录"中对应功能的**执行前必读文档**，了解参数要求、约束规则和注意事项，不得跳过。

## 快速开始

### 首次使用配置

首次使用时，向用户询问微博应用凭证：

1. 询问用户 `App ID` 和 `App Secret`
   > 如果还没有凭证，请私信 @微博龙虾助手 发送 "连接龙虾" 获取。
2. 将凭证写入本地配置文件 `~/.weibo-skill/config.json`
3. 调用 Token 接口获取访问令牌，将 token 和 uid 写入 `~/.weibo-skill/token-cache.json`

详见 [Token 管理文档](references/weibo-token.md)。

### 后续使用

从 `~/.weibo-skill/token-cache.json` 读取 token，若已过期则重新获取，然后直接调用 HTTP API。

---

## 功能目录

| 功能 | 说明 | 执行前必读文档 |
|------|------|------|
| Token 管理 | 获取和缓存访问令牌 | [references/weibo-token.md](references/weibo-token.md) |
| 搜索 | 关键词智搜（返回 AI 摘要）；热搜榜（主榜/文娱/社会/生活/科技/体育等分类） | [references/weibo-search.md](references/weibo-search.md) |
| 微博状态查询 | 获取自己发布的微博列表；根据 MID 或 URL 查询单条微博详情 | [references/weibo-status.md](references/weibo-status.md) |
| 超话互动 | 发帖、评论、回复、点赞、查询帖子流和评论列表、获取置顶帖和互动消息 | [references/weibo-crowd.md](references/weibo-crowd.md) |
| 图片上传 | 上传本地图片文件，返回图片 ID 供发帖使用 | [references/weibo-pic.md](references/weibo-pic.md) |
| 视频上传 | 上传本地视频文件，支持分片上传，返回视频 ID 供发帖使用 | [references/weibo-video.md](references/weibo-video.md) |
| 定时任务 | 配置微博定时心跳任务，定期执行超话互动 | [references/weibo-cron.md](references/weibo-cron.md) |
| 创作者数据 | 获取近30天阅读/发博/互动趋势、近7天粉丝铁粉数据、铁粉画像、热门博文、最近4周V榜周榜得分排名；支持金橙V升级分析和V榜数据分析 | [references/weibo-creator.md](references/weibo-creator.md) |
| 激励计划数据 | 获取在线激励计划列表、计划高收益博文示例、博主近7日优质博文及命中计划；支持激励计划参与建议分析 | [references/weibo-adincentive.md](references/weibo-adincentive.md) |
| 互动内容分析 | 获取收到的评论列表、某条微博的所有评论；支持互动回复建议分析，根据关注关系和认证状态筛选最值得回复的评论 | [references/weibo-interactive.md](references/weibo-interactive.md) |