SocialDataX 今日头条 MCP
今日头条热搜、内容关键词搜索、搜索建议、用户搜索、内容详情、一级评论、评论回复、用户资料与用户作品；内容搜索、评论和作品支持分页。
我该使用它吗
质量与安全性
B
发现（18）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domain在 socialdatax_get_points_balance 中
- LOWTool 'toutiao_get_hot_search_list' description lacks action verb在 toutiao_get_hot_search_list 中
- LOWTool 'toutiao_search_suggestions' description lacks action verb在 toutiao_search_suggestions 中
- LOWTool 'toutiao_search_users' description lacks action verb在 toutiao_search_users 中
- LOWTool 'toutiao_get_user_posts_by_user_id' description lacks action verb在 toutiao_get_user_posts_by_user_id 中
- LOWTool 'toutiao_get_user_posts_by_profile_url' description lacks action verb在 toutiao_get_user_posts_by_profile_url 中
- LOWTool 'toutiao_get_post_comment_replies_by_comment_id' description lacks action verb在 toutiao_get_post_comment_replies_by_comment_id 中
- LOWTool 'toutiao_search_posts' description lacks action verb在 toutiao_search_posts 中
- LOWTool 'socialdatax_get_points_balance' description lacks action verb在 socialdatax_get_points_balance 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~9,741token 数（工具定义）
~5.6 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 7.61%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"toutiao": {
"url": "https://mcp.socialdatax.com/toutiao/mcp"
}
}
}远程端点
https://mcp.socialdatax.com/toutiao/mcpstreamable-http它能做什么
工具清单
工具（14）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢toutiao_get_hot_search_list
读取今日头条热搜榜，返回头条当前热门关键词及上游热度信息。
输入模式
{
"type": "object",
"properties": {},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "普通热搜条目。",
"items": {
"properties": {
"rank": {
"description": "热搜排名，按头条返回顺序生成。",
"type": "integer"
},
"hot_id": {
"description": "热点 ID。",
"type": "string"
},
"title": {
"description": "热点标题。",
"type": "string"
},
"keyword": {
"description": "热点关键词。",
"type": "string"
},
"hot_value": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "热度值；未提供时为 null。"
},
"url": {
"description": "热点链接。",
"type": "string"
},
"cover_image_url": {
"description": "热点封面图；没有时为空字符串。",
"type": "string"
},
"tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "热点标签；没有时省略。"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "热点分类；没有时省略。"
}
},
"required": [
"rank",
"hot_id",
"title",
"keyword",
"hot_value",
"url",
"cover_image_url"
],
"type": "object"
},
"type": "array"
},
"pinned_items": {
"description": "平台置顶内容。",
"items": {
"properties": {
"title": {
"description": "置顶内容标题。",
"type": "string"
},
"url": {
"description": "置顶内容链接。",
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"pinned_items",
"points"
]
}🟢toutiao_search_suggestions(keyword)
获取今日头条搜索输入框的联想词；不返回用户或内容详情，不支持分页。
输入模式
{
"type": "object",
"properties": {
"keyword": {
"description": "搜索关键词或短语，例如美食、旅行；不要传链接、用户 ID 或 page_token。",
"minLength": 1,
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "搜索建议列表；无匹配建议时为空数组。",
"items": {
"properties": {
"text": {
"description": "搜索输入框联想词。",
"minLength": 1,
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"type": "array"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"points"
]
}🟢toutiao_search_users(keyword, page_token)
按关键词查找今日头条用户，返回用户 ID、名称、简介、粉丝数和认证说明，支持分页；已有用户 ID 或主页链接时直接查询用户资料。
输入模式
{
"type": "object",
"properties": {
"keyword": {
"description": "用户名称或关键词，例如 NBA、美食；不要传内容链接或用户主页链接。",
"minLength": 1,
"type": "string"
},
"page_token": {
"default": "",
"description": "首次留空；续页原样传入同一用户搜索上一页的 next_page_token，并保持 keyword 不变；不能使用内容搜索令牌。",
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页用户列表。",
"items": {
"properties": {
"user_id": {
"description": "头条数字用户 ID，可用于查询用户资料和作品。",
"type": "string"
},
"name": {
"description": "用户显示名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "头像链接；未提供时为 null。"
},
"profile_url": {
"description": "头条用户主页链接。",
"type": "string"
},
"bio": {
"description": "用户简介；未填写时为空字符串。",
"type": "string"
},
"follower_count": {
"description": "粉丝数。",
"type": "integer"
},
"verification_label": {
"description": "搜索结果展示的认证或身份说明；本次搜索未提供时为空字符串，不代表账号未认证。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"follower_count",
"verification_label"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页完整分页令牌；为空表示结束。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢toutiao_get_user_info_by_user_id(user_id)
读取头条用户资料和主页统计，缩略统计为近似值；已有数字用户 ID 时优先使用本工具，只有主页链接时使用 toutiao_get_user_info_by_profile_url。
输入模式
{
"type": "object",
"properties": {
"user_id": {
"description": "头条数字用户 ID，可取搜索或详情的 author.user_id；不要传内容 ID、主页链接或主页标识。",
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"user_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"user_id": {
"description": "数字用户 ID，可用于查询用户资料。",
"type": "string"
},
"name": {
"description": "用户显示名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；未提供时为 null。"
},
"profile_url": {
"description": "用户主页链接，可用于再次查询用户资料。",
"type": "string"
},
"bio": {
"description": "用户简介；未填写时为空字符串。",
"type": "string"
},
"verified": {
"description": "用户是否已认证。",
"type": "boolean"
},
"verification_label": {
"description": "认证说明；无认证说明时为空字符串。",
"type": "string"
},
"ip_location": {
"description": "主页显示的 IP 属地；未提供时为空字符串。",
"type": "string"
},
"follower_count": {
"description": "粉丝数；头条使用万等缩略显示时为换算的近似值。",
"type": "integer"
},
"following_count": {
"description": "关注数；头条使用万等缩略显示时为换算的近似值。",
"type": "integer"
},
"received_like_count": {
"description": "累计获赞数；头条使用万等缩略显示时为换算的近似值。",
"type": "integer"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verified",
"verification_label",
"ip_location",
"follower_count",
"following_count",
"received_like_count",
"points"
]
}🟢toutiao_get_user_info_by_profile_url(profile_url)
通过用户主页链接或分享文案读取头条用户资料和主页统计，缩略统计为近似值；同时有数字用户 ID 时优先使用 toutiao_get_user_info_by_user_id。
输入模式
{
"type": "object",
"properties": {
"profile_url": {
"description": "头条用户主页链接或包含主页链接的分享文案，可取详情 author.profile_url；不要传内容链接或纯 ID。",
"pattern": "https?://",
"type": "string"
}
},
"required": [
"profile_url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"user_id": {
"description": "数字用户 ID，可用于查询用户资料。",
"type": "string"
},
"name": {
"description": "用户显示名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；未提供时为 null。"
},
"profile_url": {
"description": "用户主页链接，可用于再次查询用户资料。",
"type": "string"
},
"bio": {
"description": "用户简介；未填写时为空字符串。",
"type": "string"
},
"verified": {
"description": "用户是否已认证。",
"type": "boolean"
},
"verification_label": {
"description": "认证说明；无认证说明时为空字符串。",
"type": "string"
},
"ip_location": {
"description": "主页显示的 IP 属地；未提供时为空字符串。",
"type": "string"
},
"follower_count": {
"description": "粉丝数；头条使用万等缩略显示时为换算的近似值。",
"type": "integer"
},
"following_count": {
"description": "关注数；头条使用万等缩略显示时为换算的近似值。",
"type": "integer"
},
"received_like_count": {
"description": "累计获赞数；头条使用万等缩略显示时为换算的近似值。",
"type": "integer"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verified",
"verification_label",
"ip_location",
"follower_count",
"following_count",
"received_like_count",
"points"
]
}🟢toutiao_get_user_posts_by_user_id(user_id, content_type, page_token)
读取头条用户发布的作品；已有数字用户 ID 时使用本工具，有主页链接时使用按主页链接查询的工具。
输入模式
{
"type": "object",
"properties": {
"user_id": {
"description": "头条数字用户 ID，可取用户信息或内容作者的 author.user_id；有主页链接时使用 toutiao_get_user_posts_by_profile_url。",
"pattern": "^[0-9]+$",
"type": "string"
},
"content_type": {
"default": "all",
"description": "作品筛选：all、article、video、micro_post。",
"enum": [
"all",
"article",
"video",
"micro_post"
],
"type": "string"
},
"page_token": {
"default": "",
"description": "上一页返回的分页令牌；首次留空，不能跨用户或作品类型复用。",
"type": "string"
}
},
"required": [
"user_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "用户发布的作品列表。",
"items": {
"properties": {
"post_id": {
"description": "作品 ID。",
"type": "string"
},
"content_type": {
"description": "作品类型：article、video 或 micro_post。",
"enum": [
"article",
"video",
"micro_post"
],
"type": "string"
},
"title": {
"description": "作品标题；微头条没有独立标题时为空字符串。",
"type": "string"
},
"content": {
"description": "文章为列表摘要，微头条为正文，视频通常为空字符串；完整内容请查询作品详情。",
"type": "string"
},
"post_url": {
"description": "作品链接。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图片链接；未提供时为 null。"
},
"images": {
"description": "作品图片；无图片时为空数组。",
"items": {
"properties": {
"url": {
"description": "图片链接。",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；未提供时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；未提供时为 null。"
}
},
"required": [
"url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"video_url": {
"description": "视频播放链接，有效期有限，建议获取后及时使用。",
"type": "string"
},
"duration_ms": {
"description": "视频时长，单位毫秒。",
"type": "integer"
},
"width": {
"description": "视频宽度，像素。",
"type": "integer"
},
"height": {
"description": "视频高度，像素。",
"type": "integer"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "视频播放信息；非视频作品省略。"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；未提供时为 null。"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论数；未提供时为 null。"
},
"read_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "阅读数；未提供时为 null。"
},
"author": {
"properties": {
"user_id": {
"description": "作者数字用户 ID，可用于查询用户资料或作品。",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者显示名称；未提供时为 null。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；未提供时为 null。"
},
"profile_url": {
"description": "作者头条主页链接。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "作品作者。"
}
},
"required": [
"post_id",
"content_type",
"title",
"content",
"post_url",
"publish_time",
"cover_image_url",
"images",
"like_count",
"comment_count",
"read_count",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示结束。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢toutiao_get_user_posts_by_profile_url(profile_url, content_type, page_token)
通过头条用户主页链接读取其发布的作品；支持文章、视频和微头条及分页。
输入模式
{
"type": "object",
"properties": {
"profile_url": {
"description": "头条用户主页链接或包含主页链接的分享文案；只有数字用户 ID 时使用 toutiao_get_user_posts_by_user_id。",
"pattern": "https?://",
"type": "string"
},
"content_type": {
"default": "all",
"description": "作品筛选：all、article、video、micro_post。",
"enum": [
"all",
"article",
"video",
"micro_post"
],
"type": "string"
},
"page_token": {
"default": "",
"description": "上一页返回的分页令牌；首次留空，不能跨用户或作品类型复用。",
"type": "string"
}
},
"required": [
"profile_url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "用户发布的作品列表。",
"items": {
"properties": {
"post_id": {
"description": "作品 ID。",
"type": "string"
},
"content_type": {
"description": "作品类型：article、video 或 micro_post。",
"enum": [
"article",
"video",
"micro_post"
],
"type": "string"
},
"title": {
"description": "作品标题；微头条没有独立标题时为空字符串。",
"type": "string"
},
"content": {
"description": "文章为列表摘要，微头条为正文，视频通常为空字符串；完整内容请查询作品详情。",
"type": "string"
},
"post_url": {
"description": "作品链接。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图片链接；未提供时为 null。"
},
"images": {
"description": "作品图片；无图片时为空数组。",
"items": {
"properties": {
"url": {
"description": "图片链接。",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；未提供时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；未提供时为 null。"
}
},
"required": [
"url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"video_url": {
"description": "视频播放链接，有效期有限，建议获取后及时使用。",
"type": "string"
},
"duration_ms": {
"description": "视频时长，单位毫秒。",
"type": "integer"
},
"width": {
"description": "视频宽度，像素。",
"type": "integer"
},
"height": {
"description": "视频高度，像素。",
"type": "integer"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "视频播放信息；非视频作品省略。"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；未提供时为 null。"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论数；未提供时为 null。"
},
"read_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "阅读数；未提供时为 null。"
},
"author": {
"properties": {
"user_id": {
"description": "作者数字用户 ID，可用于查询用户资料或作品。",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者显示名称；未提供时为 null。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；未提供时为 null。"
},
"profile_url": {
"description": "作者头条主页链接。",
"type": "string"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "作品作者。"
}
},
"required": [
"post_id",
"content_type",
"title",
"content",
"post_url",
"publish_time",
"cover_image_url",
"images",
"like_count",
"comment_count",
"read_count",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示结束。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢toutiao_get_post_comment_replies_by_comment_id(comment_id, page_token)
读取指定一级评论下的回复，按头条默认顺序分页；comment_id 取一级评论结果，续页保持该 ID，不要改用回复项自身的 ID。
输入模式
{
"type": "object",
"properties": {
"comment_id": {
"description": "一级评论 ID，取一级评论结果的 comment_id；不要传内容 ID、链接或回复项自身的 comment_id。",
"pattern": "^[0-9]+$",
"type": "string"
},
"page_token": {
"default": "",
"description": "首次留空；续页原样传入同一一级评论上一页回复结果的 next_page_token，并保持 comment_id 不变；不要使用一级评论或搜索的分页令牌。",
"type": "string"
}
},
"required": [
"comment_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页评论回复列表。",
"items": {
"properties": {
"comment_id": {
"description": "回复项自身的评论 ID；不要作为回复列表的入口 ID。",
"type": "string"
},
"parent_comment_id": {
"description": "所属一级评论 ID，用于继续查询该评论的回复。",
"type": "string"
},
"reply_to_comment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "被回复的评论 ID；上游未提供时省略。"
},
"content": {
"description": "回复正文。",
"type": "string"
},
"image_urls": {
"description": "回复图片的大图链接列表；无图片时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"publish_time": {
"description": "回复发布时间，秒级 Unix 时间戳。",
"type": "integer"
},
"like_count": {
"description": "回复点赞数。",
"type": "integer"
},
"ip_location": {
"description": "回复 IP 属地；未提供时为空字符串。",
"type": "string"
},
"author": {
"properties": {
"profile_url": {
"description": "评论作者头条主页链接。",
"type": "string"
},
"user_id": {
"description": "评论作者用户 ID。",
"type": "string"
},
"name": {
"description": "评论作者显示名称。",
"type": "string"
},
"avatar_url": {
"description": "评论作者头像链接。",
"type": "string"
}
},
"required": [
"profile_url",
"user_id",
"name",
"avatar_url"
],
"type": "object",
"description": "回复作者。"
}
},
"required": [
"comment_id",
"parent_comment_id",
"content",
"image_urls",
"publish_time",
"like_count",
"ip_location",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页完整分页令牌；为空表示结束。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢toutiao_search_posts(keyword, page_token)
按关键词或短语查找今日头条公开内容，支持分页。不用于读取指定链接的详情或查找用户；不返回导航、百科、用户及视频聚合面板。
输入模式
{
"type": "object",
"properties": {
"keyword": {
"description": "搜索词或关键词短语，例如 NBA、旅行攻略；不要传作品链接、用户主页链接或内容 ID。",
"minLength": 1,
"type": "string"
},
"page_token": {
"default": "",
"description": "首次留空；续页原样传入上一页的 next_page_token，并保持 keyword 不变。",
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页内容列表，不包含聚合面板。",
"items": {
"properties": {
"post_id": {
"description": "内容 ID，以字符串表示。",
"type": "string"
},
"title": {
"description": "内容标题。",
"type": "string"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "搜索摘要，不是完整正文；未提供时为 null。"
},
"post_url": {
"description": "头条内容页面链接。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
},
"has_video": {
"description": "内容是否包含视频。",
"type": "boolean"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图片链接；未提供时为 null。"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；未提供时为 null。"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论数；未提供时为 null。"
},
"read_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "阅读数；未提供时为 null。"
},
"author": {
"properties": {
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "作者头条主页链接；没有可用用户 ID 时省略。"
},
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者用户 ID；未提供时为 null。"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者显示名称；未提供时为 null。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；未提供时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url"
],
"type": "object",
"description": "内容作者。"
}
},
"required": [
"post_id",
"title",
"summary",
"post_url",
"publish_time",
"has_video",
"cover_image_url",
"like_count",
"comment_count",
"read_count",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页完整分页令牌；为空表示结束。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢toutiao_get_post_detail_by_post_id(post_id)
读取头条文章、视频或微头条详情，包含正文、图片、作者和互动数据，视频含播放信息；输入内容数字 ID，可接续搜索结果。有链接时使用 toutiao_get_post_detail_by_url。视频说明不是语音转写。
输入模式
{
"type": "object",
"properties": {
"post_id": {
"description": "头条内容数字 ID，可取搜索结果 post_id；不要传链接。",
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"post_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"post_id": {
"description": "内容 ID，以字符串表示。",
"type": "string"
},
"title": {
"description": "内容标题；无独立标题的微头条可为空，请阅读 content。",
"type": "string"
},
"content": {
"description": "正文纯文本；纯图片内容或视频可能为空，请结合 images 和 video 阅读。视频说明不是语音转写。",
"type": "string"
},
"post_url": {
"description": "头条内容页面链接。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
},
"images": {
"description": "按正文顺序返回的图片，包含链接和像素宽高；无图片时为空数组。",
"items": {
"properties": {
"url": {
"description": "图片链接。",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；未提供时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；未提供时为 null。"
}
},
"required": [
"url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图片链接；未提供时为 null。"
},
"author": {
"properties": {
"profile_url": {
"description": "作者头条主页链接。",
"type": "string"
},
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者用户 ID；未提供时为 null。"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者显示名称；未提供时为 null。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；未提供时为 null。"
}
},
"required": [
"profile_url",
"user_id",
"name",
"avatar_url"
],
"type": "object",
"description": "内容作者，包含作者主页链接。"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；未提供时为 null。"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论数；未提供时为 null。"
},
"read_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "阅读数；未提供时为 null。"
},
"share_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "分享数；未提供时为 null。"
},
"collect_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "收藏数；未提供时为 null。"
},
"video": {
"anyOf": [
{
"properties": {
"video_url": {
"description": "视频播放链接，有效期有限，建议获取后及时使用。",
"type": "string"
},
"duration_ms": {
"description": "视频时长，单位毫秒。",
"type": "integer"
},
"width": {
"description": "视频宽度，像素。",
"type": "integer"
},
"height": {
"description": "视频高度，像素。",
"type": "integer"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "视频播放信息；当前返回无视频信息时省略。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"post_id",
"title",
"content",
"post_url",
"publish_time",
"images",
"cover_image_url",
"author",
"like_count",
"comment_count",
"read_count",
"share_count",
"collect_count",
"points"
]
}🟢toutiao_get_post_detail_by_url(url)
通过头条内容链接或分享文案读取文章、视频或微头条详情；只有内容 ID 时使用 toutiao_get_post_detail_by_post_id。视频说明不是语音转写。
输入模式
{
"type": "object",
"properties": {
"url": {
"description": "头条内容链接或包含该链接的分享文案，支持 /article/ID/、/aID/、/video/ID/ 和 /w/ID/，可取搜索结果 post_url；不要传纯 ID。",
"pattern": "https?://",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"post_id": {
"description": "内容 ID，以字符串表示。",
"type": "string"
},
"title": {
"description": "内容标题；无独立标题的微头条可为空，请阅读 content。",
"type": "string"
},
"content": {
"description": "正文纯文本；纯图片内容或视频可能为空，请结合 images 和 video 阅读。视频说明不是语音转写。",
"type": "string"
},
"post_url": {
"description": "头条内容页面链接。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；未提供时为 null。"
},
"images": {
"description": "按正文顺序返回的图片，包含链接和像素宽高；无图片时为空数组。",
"items": {
"properties": {
"url": {
"description": "图片链接。",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；未提供时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；未提供时为 null。"
}
},
"required": [
"url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图片链接；未提供时为 null。"
},
"author": {
"properties": {
"profile_url": {
"description": "作者头条主页链接。",
"type": "string"
},
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者用户 ID；未提供时为 null。"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者显示名称；未提供时为 null。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；未提供时为 null。"
}
},
"required": [
"profile_url",
"user_id",
"name",
"avatar_url"
],
"type": "object",
"description": "内容作者，包含作者主页链接。"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；未提供时为 null。"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论数；未提供时为 null。"
},
"read_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "阅读数；未提供时为 null。"
},
"share_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "分享数；未提供时为 null。"
},
"collect_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "收藏数；未提供时为 null。"
},
"video": {
"anyOf": [
{
"properties": {
"video_url": {
"description": "视频播放链接，有效期有限，建议获取后及时使用。",
"type": "string"
},
"duration_ms": {
"description": "视频时长，单位毫秒。",
"type": "integer"
},
"width": {
"description": "视频宽度，像素。",
"type": "integer"
},
"height": {
"description": "视频高度，像素。",
"type": "integer"
}
},
"required": [
"video_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "视频播放信息；当前返回无视频信息时省略。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"post_id",
"title",
"content",
"post_url",
"publish_time",
"images",
"cover_image_url",
"author",
"like_count",
"comment_count",
"read_count",
"share_count",
"collect_count",
"points"
]
}🟢toutiao_get_post_comments_by_post_id(post_id, page_token)
读取头条文章、视频或微头条的一级评论，按头条默认顺序返回，支持分页，不包含评论回复；输入内容数字 ID，支持接续搜索结果；有链接时使用 toutiao_get_post_comments_by_url。
输入模式
{
"type": "object",
"properties": {
"post_id": {
"description": "头条内容数字 ID，可取搜索结果 post_id；不要传链接。",
"pattern": "^[0-9]+$",
"type": "string"
},
"page_token": {
"default": "",
"description": "首次留空；续页原样传入同一内容上一页评论结果的 next_page_token；不要使用搜索结果的分页令牌。",
"type": "string"
}
},
"required": [
"post_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页一级评论列表。",
"items": {
"properties": {
"comment_id": {
"description": "一级评论 ID，以字符串表示。",
"type": "string"
},
"content": {
"description": "评论正文。",
"type": "string"
},
"image_urls": {
"description": "评论图片的大图链接列表；无图片时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"publish_time": {
"description": "评论发布时间，秒级 Unix 时间戳。",
"type": "integer"
},
"like_count": {
"description": "评论点赞数。",
"type": "integer"
},
"has_replies": {
"description": "评论是否有回复。",
"type": "boolean"
},
"ip_location": {
"description": "评论 IP 属地；未提供时为空字符串。",
"type": "string"
},
"author": {
"properties": {
"profile_url": {
"description": "评论作者头条主页链接。",
"type": "string"
},
"user_id": {
"description": "评论作者用户 ID。",
"type": "string"
},
"name": {
"description": "评论作者显示名称。",
"type": "string"
},
"avatar_url": {
"description": "评论作者头像链接。",
"type": "string"
}
},
"required": [
"profile_url",
"user_id",
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者。"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"publish_time",
"like_count",
"has_replies",
"ip_location",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页完整分页令牌；为空表示结束。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢toutiao_get_post_comments_by_url(url, page_token)
通过头条内容链接或分享文案读取一级评论，按头条默认顺序返回，支持分页，不包含评论回复；只有内容 ID 时使用 toutiao_get_post_comments_by_post_id。
输入模式
{
"type": "object",
"properties": {
"url": {
"description": "头条内容链接或包含该链接的分享文案，支持 /article/ID/、/aID/、/video/ID/ 和 /w/ID/，可取搜索结果 post_url；不要传纯 ID。",
"pattern": "https?://",
"type": "string"
},
"page_token": {
"default": "",
"description": "首次留空；续页原样传入同一内容上一页评论结果的 next_page_token；不要使用搜索结果的分页令牌。",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页一级评论列表。",
"items": {
"properties": {
"comment_id": {
"description": "一级评论 ID，以字符串表示。",
"type": "string"
},
"content": {
"description": "评论正文。",
"type": "string"
},
"image_urls": {
"description": "评论图片的大图链接列表；无图片时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"publish_time": {
"description": "评论发布时间，秒级 Unix 时间戳。",
"type": "integer"
},
"like_count": {
"description": "评论点赞数。",
"type": "integer"
},
"has_replies": {
"description": "评论是否有回复。",
"type": "boolean"
},
"ip_location": {
"description": "评论 IP 属地；未提供时为空字符串。",
"type": "string"
},
"author": {
"properties": {
"profile_url": {
"description": "评论作者头条主页链接。",
"type": "string"
},
"user_id": {
"description": "评论作者用户 ID。",
"type": "string"
},
"name": {
"description": "评论作者显示名称。",
"type": "string"
},
"avatar_url": {
"description": "评论作者头像链接。",
"type": "string"
}
},
"required": [
"profile_url",
"user_id",
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者。"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"publish_time",
"like_count",
"has_replies",
"ip_location",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页完整分页令牌；为空表示结束。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢socialdatax_get_points_balance
查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
输入模式
{
"type": "object",
"properties": {},
"additionalProperties": false
}输出模式
{
"type": "object",
"additionalProperties": {
"type": "integer"
}
}社区
证据
最近观测
已验证未记录版本14 个工具