| name | weibo-token |
| description | 微博 API 访问令牌工具。用于获取和管理微博 API 的访问 token。
此工具为其他微博工具（热搜、搜索、用户微博等）提供统一的 token 管理服务。
token 有效期为 2 小时，工具会自动缓存和刷新。
|
| metadata | {"version":"1.0.0"} |
微博 Token 工具
使用 weibo_token 工具获取微博 API 访问令牌。此工具提供统一的 token 管理服务，为其他微博工具提供认证支持。
基本用法
{
"tool_calls": [
{
"name": "weibo_token",
"arguments": {}
}
]
}
此工具不需要任何参数，直接调用即可获取当前有效的 token。
参数说明
此工具无需参数。
返回结果
成功时返回：
{
"success": true,
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"acquiredAt": "2026-03-12T15:30:00.000Z",
"expiresIn": 7200,
"expiresAt": "2026-03-12T17:30:00.000Z"
}
错误时返回：
{
"success": false,
"error": "获取微博 token 失败: 错误信息"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|
success | boolean | 是否成功获取 token |
token | string | 访问令牌 |
acquiredAt | string | token 获取时间（ISO 8601 格式） |
expiresIn | number | token 有效期（秒），默认 7200 秒（2小时） |
expiresAt | string | token 过期时间（ISO 8601 格式） |
配置（必填）
{
"channels": {
"weibo": {
"appId": "your_app_id",
"appSecret": "your_app_secret"
}
}
}
配置项说明
| 配置项 | 类型 | 必填 | 默认值 | 说明 |
|---|
appId | string | 是 | - | 应用 ID，用于获取 token |
appSecret | string | 是 | - | 应用密钥，用于获取 token |
tokenEndpoint | string | 否 | https://open-im.api.weibo.com/open/auth/ws_token | Token 获取端点 |
weiboTokenEnabled | boolean | 否 | true | 是否启用 token 工具 |
API 说明
此工具使用微博开放平台的 token 接口：
获取 Token
POST https://open-im.api.weibo.com/open/auth/ws_token
Content-Type: application/json
{
"app_id": "your_app_id",
"app_secret": "your_app_secret"
}
响应示例
{
"data": {
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expire_in": 7200
}
}
Token 缓存机制
- 自动缓存：首次获取的 token 会被缓存
- 自动刷新：在 token 过期前 60 秒自动刷新
- 共享使用：所有微博工具共享同一个 token 缓存
使用场景
此工具主要用于以下场景：
- 调试：检查当前 token 状态和有效期
- 预热：在使用其他微博工具前预先获取 token
- 监控：监控 token 的获取和刷新情况
与其他工具的关系
以下微博工具依赖此 token 工具进行认证：
weibo_hot_search - 微博热搜榜weibo_search - 微博智搜weibo_status - 用户微博
这些工具会自动调用 token 管理功能，无需手动获取 token。
注意事项
- 此工具需要配置
appId 和 appSecret 才能使用
- Token 有效期为 2 小时（7200 秒）
- 工具会在 token 过期前 60 秒自动刷新
- 所有微博工具共享同一个 token 缓存，避免重复获取
