X/Twitter search, posts, comments, user profiles, user posts/replies and video transcripts.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer API Key from SocialDataX / 社媒数据助手
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
This tool takes no arguments.
查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}根据 X 帖子 ID 和一级评论 ID 获取公开评论回复列表；用户已提供完整合法的 ID 组合时直接使用；已有 post_id 或帖子链接但缺少必需 ID 时，调用对应一级评论工具补全；缺少帖子定位信息时向用户索取；不要传评论回复结果里的 comment_id 或评论链接。
| Argument | Type | Description |
|---|---|---|
| post_id* | string | X 帖子 ID；用户已提供时直接使用，否则请原样复制获取一级评论时使用的 post_id，或评论列表 items[*].post_id；必须是数字字符串；不要传评论 ID、帖子链接、用户名或分享文案。 |
| comment_id* | string | X 一级评论 ID；用户已提供时直接使用，否则请原样复制 x_get_post_comments_by_post_id 或 x_get_post_comments_by_post_url 返回的 items[*].comment_id；不要传帖子 ID、评论回复结果里的 items[*].comment_id、评论链接、用户主页链接或分享文案。 |
| page_token | string | X 评论回复列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子下同一条一级评论的回复列表；切换 post_id 或 comment_id 时请清空 page_token 后从第一页重新获取。 |
{
"type": "object",
"required": [
"post_id",
"comment_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "X 帖子 ID；用户已提供时直接使用，否则请原样复制获取一级评论时使用的 post_id，或评论列表 items[*].post_id；必须是数字字符串；不要传评论 ID、帖子链接、用户名或分享文案。"
},
"comment_id": {
"type": "string",
"description": "X 一级评论 ID；用户已提供时直接使用，否则请原样复制 x_get_post_comments_by_post_id 或 x_get_post_comments_by_post_url 返回的 items[*].comment_id；不要传帖子 ID、评论回复结果里的 items[*].comment_id、评论链接、用户主页链接或分享文案。"
},
"page_token": {
"type": "string",
"default": "",
"description": "X 评论回复列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子下同一条一级评论的回复列表；切换 post_id 或 comment_id 时请清空 page_token 后从第一页重新获取。"
}
},
"additionalProperties": false
}根据 X 帖子 ID 获取公开帖子的一级评论列表，不内嵌评论回复；已知 post_id 时优先使用，不要传帖子链接或评论 ID。
| Argument | Type | Description |
|---|---|---|
| post_id* | string | X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名、评论 ID 或分享文案。 |
| page_token | string | X 帖子评论列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论列表；切换到其他帖子时请清空 page_token 后从第一页重新获取。 |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名、评论 ID 或分享文案。"
},
"page_token": {
"type": "string",
"default": "",
"description": "X 帖子评论列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论列表；切换到其他帖子时请清空 page_token 后从第一页重新获取。"
}
},
"additionalProperties": false
}根据 X 帖子链接获取公开帖子的一级评论列表，不内嵌评论回复；仅在没有 post_id、只有帖子链接或结果里的非空 post_url 时使用。
| Argument | Type | Description |
|---|---|---|
| post_url* | string | X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。 |
| page_token | string | X 帖子评论列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论列表；切换到其他帖子时请清空 page_token 后从第一页重新获取。 |
{
"type": "object",
"required": [
"post_url"
],
"properties": {
"post_url": {
"type": "string",
"description": "X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"
},
"page_token": {
"type": "string",
"default": "",
"description": "X 帖子评论列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一帖子评论列表；切换到其他帖子时请清空 page_token 后从第一页重新获取。"
}
},
"additionalProperties": false
}根据 X 帖子 ID 获取公开帖子详情；已知 post_id 时优先使用，不要传帖子链接。
| Argument | Type | Description |
|---|---|---|
| post_id* | string | X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。 |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。"
}
},
"additionalProperties": false
}根据 X 帖子链接获取公开帖子详情；仅在没有 post_id、只有帖子链接或结果里的非空 post_url 时使用。
| Argument | Type | Description |
|---|---|---|
| post_url* | string | X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、帖子正文里的链接、搜索关键词或接口地址。 |
{
"type": "object",
"required": [
"post_url"
],
"properties": {
"post_url": {
"type": "string",
"description": "X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、帖子正文里的链接、搜索关键词或接口地址。"
}
},
"additionalProperties": false
}根据 X 用户主页链接获取公开用户信息；可使用用户搜索结果的非空 items[*].profile_url，或帖子及评论结果的非空 author.profile_url。不要传帖子链接。
| Argument | Type | Description |
|---|---|---|
| profile_url* | string | X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。 |
{
"type": "object",
"required": [
"profile_url"
],
"properties": {
"profile_url": {
"type": "string",
"description": "X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"
}
},
"additionalProperties": false
}根据 X 用户 ID 获取公开用户信息；已有完整 user_id 时直接使用。
| Argument | Type | Description |
|---|---|---|
| user_id* | string | X 用户稳定数字 ID；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。 |
{
"type": "object",
"required": [
"user_id"
],
"properties": {
"user_id": {
"type": "string",
"description": "X 用户稳定数字 ID；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。"
}
},
"additionalProperties": false
}根据 X 用户名获取公开用户信息；可使用用户搜索结果的非空 items[*].username，或帖子及评论结果的非空 author.username。
| Argument | Type | Description |
|---|---|---|
| username* | string | X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。 |
{
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"description": "X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。"
}
},
"additionalProperties": false
}根据 X 用户主页链接获取公开用户帖子列表；可使用用户搜索结果的非空 items[*].profile_url，或帖子及评论结果的非空 author.profile_url。不要传帖子链接。支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| page_token | string | X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。 |
| profile_url* | string | X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。 |
{
"type": "object",
"required": [
"profile_url"
],
"properties": {
"page_token": {
"type": "string",
"default": "",
"description": "X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。"
},
"profile_url": {
"type": "string",
"description": "X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"
}
},
"additionalProperties": false
}根据 X 用户 ID 获取公开用户帖子列表；已有完整 user_id 时直接使用，支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| user_id* | string | X 用户稳定数字 ID；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。 |
| page_token | string | X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。 |
{
"type": "object",
"required": [
"user_id"
],
"properties": {
"user_id": {
"type": "string",
"description": "X 用户稳定数字 ID；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。"
},
"page_token": {
"type": "string",
"default": "",
"description": "X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。"
}
},
"additionalProperties": false
}根据 X 用户名获取公开用户帖子列表；可使用用户搜索结果的非空 items[*].username，或帖子及评论结果的非空 author.username。支持 page_token 翻页。
| Argument | Type | Description |
|---|---|---|
| username* | string | X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。 |
| page_token | string | X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。 |
{
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"description": "X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。"
},
"page_token": {
"type": "string",
"default": "",
"description": "X 用户帖子列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户帖子列表；切换 user_id、username 或 profile_url 时请清空 page_token 后从第一页重新获取。"
}
},
"additionalProperties": false
}根据 X 用户主页链接获取该博主发布的回复帖子，包括自回复，支持分页；查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时，使用对应评论工具。
| Argument | Type | Description |
|---|---|---|
| page_token | string | 首次请求留空；继续翻页时原样传回完整 next_page_token，保持同一用户及定位方式。不能与用户帖子列表或其他工具的分页令牌混用。 |
| profile_url* | string | X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。 |
{
"type": "object",
"required": [
"profile_url"
],
"properties": {
"page_token": {
"type": "string",
"default": "",
"description": "首次请求留空；继续翻页时原样传回完整 next_page_token，保持同一用户及定位方式。不能与用户帖子列表或其他工具的分页令牌混用。"
},
"profile_url": {
"type": "string",
"description": "X 用户主页链接；也接受用户提供的 x.com 或 twitter.com 用户主页链接。可从用户搜索结果的非空 items[*].profile_url、用户详情的非空 profile_url，或帖子及评论结果的非空作者字段 author.profile_url 原样复制；不要传帖子链接、评论链接、帖子正文里的链接、搜索关键词或接口地址。"
}
},
"additionalProperties": false
}根据 X 用户 ID获取该博主发布的回复帖子，包括自回复，支持分页；查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时，使用对应评论工具。
| Argument | Type | Description |
|---|---|---|
| user_id* | string | X 用户稳定数字 ID；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。 |
| page_token | string | 首次请求留空；继续翻页时原样传回完整 next_page_token，保持同一用户及定位方式。不能与用户帖子列表或其他工具的分页令牌混用。 |
{
"type": "object",
"required": [
"user_id"
],
"properties": {
"user_id": {
"type": "string",
"description": "X 用户稳定数字 ID；用户已提供时原样使用；必须是数字字符串。可从用户搜索结果的非空 items[*].user_id、用户详情的非空 user_id，或帖子及评论结果的非空作者字段 author.user_id 原样复制；不要传用户名、用户主页链接、帖子链接或分享文案。"
},
"page_token": {
"type": "string",
"default": "",
"description": "首次请求留空；继续翻页时原样传回完整 next_page_token，保持同一用户及定位方式。不能与用户帖子列表或其他工具的分页令牌混用。"
}
},
"additionalProperties": false
}根据 X 用户名获取该博主发布的回复帖子，包括自回复，支持分页；查看博主回复过什么时使用。查看某条帖子下的评论或评论下的回复时，使用对应评论工具。
| Argument | Type | Description |
|---|---|---|
| username* | string | X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。 |
| page_token | string | 首次请求留空；继续翻页时原样传回完整 next_page_token，保持同一用户及定位方式。不能与用户帖子列表或其他工具的分页令牌混用。 |
{
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"description": "X 用户名，不带 @；也接受用户提供的 @username。可从用户搜索结果的非空 items[*].username、用户详情的非空 username，或帖子及评论结果的非空作者字段 author.username 原样复制；不要传用户主页链接、帖子链接或分享文案。"
},
"page_token": {
"type": "string",
"default": "",
"description": "首次请求留空；继续翻页时原样传回完整 next_page_token，保持同一用户及定位方式。不能与用户帖子列表或其他工具的分页令牌混用。"
}
},
"additionalProperties": false
}根据用户提供的有效 job_id，或 submit 工具返回的 job_id 查询 X / Twitter 口播转文字任务；每次最多等待 240 秒，不触发重处理，也不要重复提交任务。
| Argument | Type | Description |
|---|---|---|
| job_id* | string | 口播转文字任务 ID；用户已提供时直接使用，否则使用 x_submit_video_speech_text_by_post_url 或 x_submit_video_speech_text_by_post_id 返回的 job_id；任务未完成时继续原样传入同一个 job_id，不要重复提交。 |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 x_submit_video_speech_text_by_post_url 或 x_submit_video_speech_text_by_post_id 返回的 job_id；任务未完成时继续原样传入同一个 job_id，不要重复提交。"
}
},
"additionalProperties": false
}按搜索词搜索 X / Twitter 公开帖子，只返回帖子结果。用户需要按搜索词查找帖子时使用；已有 post_id 或 post_url 时使用帖子详情或评论工具；已有 user_id、username 或 profile_url 时使用用户信息或用户帖子工具；支持 page_token 翻页和热门/最新排序。
| Argument | Type | Description |
|---|---|---|
| keyword* | string | X / Twitter 帖子搜索词，可传关键词或短语，例如品牌名、话题、人物名或内容需求；不要传帖子链接、用户主页链接、接口地址、post_id、user_id、username 或 page_token。 |
| sort_type | string | 搜索排序：hot=热门，time_descending=最新；需要 latest/newest sorting 时也传 time_descending。如无明确排序需求，保持 hot。 |
| page_token | string | X 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词和同一搜索排序链路；更换关键词或 sort_type 时，请清空 page_token 后从第一页重新搜索。 |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "X / Twitter 帖子搜索词，可传关键词或短语，例如品牌名、话题、人物名或内容需求；不要传帖子链接、用户主页链接、接口地址、post_id、user_id、username 或 page_token。"
},
"sort_type": {
"enum": [
"hot",
"time_descending"
],
"type": "string",
"default": "hot",
"description": "搜索排序：hot=热门，time_descending=最新；需要 latest/newest sorting 时也传 time_descending。如无明确排序需求，保持 hot。"
},
"page_token": {
"type": "string",
"default": "",
"description": "X 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词和同一搜索排序链路；更换关键词或 sort_type 时，请清空 page_token 后从第一页重新搜索。"
}
},
"additionalProperties": false
}获取 X / Twitter 搜索框的关键词联想，不返回帖子或推荐用户，不支持分页。可将返回的 text 用于帖子搜索；已有明确搜索词时可直接搜索帖子。
| Argument | Type | Description |
|---|---|---|
| keyword* | string | 搜索关键词或短语，例如 food、OpenAI；不要传帖子链接、用户主页链接、ID 或分页令牌。 |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"minLength": 1,
"description": "搜索关键词或短语，例如 food、OpenAI；不要传帖子链接、用户主页链接、ID 或分页令牌。"
}
},
"additionalProperties": false
}按关键词搜索 X / Twitter 用户，返回用户资料和分页令牌，支持 page_token 翻页。用于按名称发现账号；已知 user_id、username 或主页链接时，使用对应用户详情工具。
| Argument | Type | Description |
|---|---|---|
| keyword* | string | 用户搜索关键词或名称，例如 OpenAI；不要传用户 ID、主页链接或分页令牌。 |
| page_token | string | 首次请求留空；继续翻页时原样传入上次的 next_page_token，并保持 keyword 不变。 |
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"minLength": 1,
"description": "用户搜索关键词或名称，例如 OpenAI；不要传用户 ID、主页链接或分页令牌。"
},
"page_token": {
"type": "string",
"default": "",
"description": "首次请求留空；继续翻页时原样传入上次的 next_page_token，并保持 keyword 不变。"
}
},
"additionalProperties": false
}根据 X / Twitter 视频帖子的 post_id 提交口播转文字任务；只处理当前帖子自身首个可用 MP4 视频，提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
| Argument | Type | Description |
|---|---|---|
| post_id* | string | X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。 |
{
"type": "object",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"description": "X 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。"
}
},
"additionalProperties": false
}根据 X / Twitter 视频帖子链接提交口播转文字任务；只处理当前帖子自身首个可用 MP4 视频，提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
| Argument | Type | Description |
|---|---|---|
| post_url* | string | X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、帖子正文里的链接、搜索关键词或接口地址。 |
{
"type": "object",
"required": [
"post_url"
],
"properties": {
"post_url": {
"type": "string",
"description": "X 帖子链接；仅在没有 post_id 时，请传搜索结果、详情结果、quoted_post 或 reposted_post 返回的非空 post_url，或用户帖子列表结果返回的非空 post_url，或形如 https://x.com/{username}/status/{post_id} 的 x.com 或 twitter.com 帖子页面链接；不要传用户主页链接、帖子正文里的链接、搜索关键词或接口地址。"
}
},
"additionalProperties": false
}