Back to Details

twitter

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Twitter/X — Dual-Mode Integration

Twitter/X — 多模式集成

Three tools for different operations. Choose by task:
ModeToolAuthCostUse For
Official API
x-search
Bearer token$0.005/read, $0.01/userSearch, research, profiles, threads, monitoring
Official API
x-search post/reply
OAuth 1.0a$0.01/postPosting, replying via official API
Session
bird
Browser cookiesFreePosting, replying, bookmarks, mentions, media
Archival
smaug
Via birdFreeBookmark/likes processing, AI-powered filing
三种工具对应不同操作，根据任务选择：
模式工具认证方式费用适用场景
官方API
x-search
Bearer token$0.005/读取，$0.01/用户搜索、调研、个人主页、推文线程、监控
官方API
x-search post/reply
OAuth 1.0a$0.01/发布通过官方API发布、回复内容
会话模式
bird
浏览器Cookie免费发布、回复、书签、提及、媒体内容
归档模式
smaug
通过bird免费书签/点赞内容处理、AI驱动的归档

Setup

配置步骤

x-search (Official API v2)

x-search（官方API v2）

Requires an X API Bearer token from console.x.com. Pay-per-use — no monthly commitment.
bash
undefined
需要从console.x.com获取X API Bearer令牌。按使用付费，无月度订阅要求。
bash
undefined

Store token (pick one)

Store token (pick one)

echo 'X_BEARER_TOKEN=your_token_here' >> ~/.claude/skills/twitter/.env
echo 'X_BEARER_TOKEN=your_token_here' >> ~/.claude/skills/twitter/.env

OR

OR

export X_BEARER_TOKEN=your_token_here
export X_BEARER_TOKEN=your_token_here

OR

OR

mkdir -p ~/.config/env && echo 'X_BEARER_TOKEN=your_token_here' >> ~/.config/env/global.env
undefined
mkdir -p ~/.config/env && echo 'X_BEARER_TOKEN=your_token_here' >> ~/.config/env/global.env
undefined

OAuth 1.0a (for posting)

OAuth 1.0a（用于发布内容）

Posting requires OAuth 1.0a credentials in addition to the Bearer token.
  1. Go to console.x.com → your project → Keys and tokens
  2. Under "Consumer Keys", copy API Key and API Key Secret
  3. Under "Authentication Tokens", generate Access Token and Access Token Secret (with Read and Write permissions)
  4. Add all four to 
    ~/.claude/skills/twitter/.env
    :
bash
X_API_KEY=your_api_key
X_API_SECRET=your_api_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
发布内容除了Bearer令牌外，还需要OAuth 1.0a凭证。
  1. 访问console.x.com → 你的项目 → 密钥与令牌
  2. 在"消费者密钥"下，复制API Key和API Key Secret
  3. 在"认证令牌"下，生成Access Token和Access Token Secret（需开启读写权限）
  4. 将这四个凭证添加到
    ~/.claude/skills/twitter/.env
    中：
bash
X_API_KEY=your_api_key
X_API_SECRET=your_api_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret

bird CLI

bird CLI

bash
brew install steipete/tap/bird   # or: npm install -g @steipete/bird
bird whoami                       # verify auth (uses browser cookies)
bash
brew install steipete/tap/bird   # or: npm install -g @steipete/bird
bird whoami                       # verify auth (uses browser cookies)

Smaug (archival)

Smaug（归档工具）

bash
cd ~/tools/smaug && npx smaug setup
bash
cd ~/tools/smaug && npx smaug setup

x-search — Official API Research

x-search — 官方API调研工具

Run via: 
bun run ~/.claude/skills/twitter/x-search/x-search.ts <command>
运行方式：
bun run ~/.claude/skills/twitter/x-search/x-search.ts <command>

Quick Search (cost-conscious default)

快速搜索（默认，成本优先）

bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "AI agents" --quick
bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "AI agents" --quick

1 page, max 10 results, auto noise filter, 1hr cache, cost summary

1页，最多10条结果，自动过滤噪音，1小时缓存，成本汇总

Est. cost: ~$0.50

预估成本：约0.50美元

undefined
undefined

Full Search

完整搜索

bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "Claude Code" --pages 3 --sort likes --since 1d
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "BG3 mods" --from LarianStudios --quality
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "Minoan archaeology" --markdown --save
bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "Claude Code" --pages 3 --sort likes --since 1d
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "BG3 mods" --from LarianStudios --quality
bun run ~/.claude/skills/twitter/x-search/x-search.ts search "Minoan archaeology" --markdown --save

Search Options

搜索选项

FlagDefaultDescription
--quick
off1 page, max 10, noise filter, 1hr cache
--sort
likes
likes|impressions|retweets|recent
--since
7d
1h|3h|12h|1d|7d
or ISO timestamp
--pages
11-5 pages (100 tweets/page)
--limit
15Max results displayed
--from
—Shorthand for 
from:username
--quality
offFilter tweets with < 10 likes
--min-likes
0Minimum like threshold
--no-replies
offExclude replies
--save
offSave markdown to 
~/tools/smaug/knowledge/research/
--json
offRaw JSON output
--markdown
offMarkdown research document
参数默认值描述
--quick
关闭1页，最多10条结果，噪音过滤，1小时缓存
--sort
likes
likes|impressions|retweets|recent
--since
7d
1h|3h|12h|1d|7d
或ISO时间戳
--pages
11-5页（每页100条推文）
--limit
15显示的最大结果数
--from
—
from:username
的简写
--quality
关闭过滤点赞数<10的推文
--min-likes
0最低点赞数阈值
--no-replies
关闭排除回复内容
--save
关闭将Markdown保存到
~/tools/smaug/knowledge/research/
--json
关闭原始JSON输出
--markdown
关闭生成Markdown调研文档

Profiles, Threads, Single Tweets

个人主页、推文线程、单条推文

bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts profile AnthropicAI --count 10
bun run ~/.claude/skills/twitter/x-search/x-search.ts thread 1234567890 --pages 3
bun run ~/.claude/skills/twitter/x-search/x-search.ts tweet 1234567890
bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts profile AnthropicAI --count 10
bun run ~/.claude/skills/twitter/x-search/x-search.ts thread 1234567890 --pages 3
bun run ~/.claude/skills/twitter/x-search/x-search.ts tweet 1234567890

Watchlist

监控列表

Monitor accounts with batch checking.
bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist                    # show list
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist add kikismith "Ancient art"
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist remove kikismith
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist check              # check all accounts
Watchlist stored at 
~/.claude/skills/twitter/x-search/data/watchlist.json
.
批量检查，监控账号动态。
bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist                    # 显示列表
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist add kikismith "Ancient art"
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist remove kikismith
bun run ~/.claude/skills/twitter/x-search/x-search.ts watchlist check              # 检查所有账号
监控列表存储在
~/.claude/skills/twitter/x-search/data/watchlist.json
。

Posting and Replying (OAuth 1.0a)

发布与回复（OAuth 1.0a）

Post tweets and replies via the official API. Requires OAuth 1.0a credentials (see setup above).
bash
undefined
通过官方API发布推文和回复。需要OAuth 1.0a凭证（见上方配置步骤）。
bash
undefined

Post a tweet

发布一条推文

bun run ~/.claude/skills/twitter/x-search/x-search.ts post "Hello from x-search!"
bun run ~/.claude/skills/twitter/x-search/x-search.ts post "Hello from x-search!"

Reply to a tweet

回复一条推文

bun run ~/.claude/skills/twitter/x-search/x-search.ts reply 1234567890 "Great thread!"

- 280-character limit enforced
- Cost: $0.01 per post
- Returns the posted tweet URL
- Errors: descriptive messages for missing credentials, permission issues, rate limits
bun run ~/.claude/skills/twitter/x-search/x-search.ts reply 1234567890 "Great thread!"

- 强制执行280字符限制
- 费用：每条发布0.01美元
- 返回已发布推文的URL
- 错误处理：针对缺失凭证、权限问题、速率限制提供详细错误信息

Cache

缓存机制

15-minute TTL (1hr in quick mode). File-based, auto-managed.
bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts cache clear
15分钟TTL（快速模式下为1小时）。基于文件存储，自动管理。
bash
bun run ~/.claude/skills/twitter/x-search/x-search.ts cache clear

Cost Reference

成本参考

ResourceCost
Post read$0.005
User lookup$0.010
Post create$0.010
Quick search (~100 tweets)~$0.50
3-page deep search (~300 tweets)~$1.50
Profile check~$0.51
Cached repeatFREE
X API deduplicates reads within 24h. Cache prevents redundant queries within 15min.
资源费用
推文读取$0.005
用户查询$0.010
推文创建$0.010
快速搜索（约100条推文）约$0.50
3页深度搜索（约300条推文）约$1.50
个人主页检查约$0.51
重复缓存查询免费
X API会在24小时内去重读取请求。缓存可防止15分钟内的重复查询。

bird CLI — Session-Based Operations

bird CLI — 会话模式操作

Uses undocumented Twitter GraphQL APIs via browser cookies. Free but may break when Twitter rotates internals.
通过浏览器Cookie调用未公开的Twitter GraphQL API。免费使用，但当Twitter更新内部机制时可能失效。

Posting

发布内容

bash
bird tweet "Hello world"
bird reply 123456789 "Great thread!"
bird tweet "With image" --media photo.png --alt "Description"
bash
bird tweet "Hello world"
bird reply 123456789 "Great thread!"
bird tweet "With image" --media photo.png --alt "Description"

Reading

读取内容

bash
bird read 123456789
bird thread https://x.com/user/status/123456789
bird replies 123456789 --json
bash
bird read 123456789
bird thread https://x.com/user/status/123456789
bird replies 123456789 --json

Search (free, via GraphQL)

搜索（免费，基于GraphQL）

bash
bird search "query" -n 10
bird search "from:anthropic" -n 20 --json
bash
bird search "query" -n 10
bird search "from:anthropic" -n 20 --json

Monitoring

监控功能

bash
bird mentions -n 10
bird bookmarks -n 20
bird likes -n 20
bird following -n 50
bird followers -n 50
bash
bird mentions -n 10
bird bookmarks -n 20
bird likes -n 20
bird following -n 50
bird followers -n 50

Maintenance

维护操作

bash
bird whoami          # verify auth
bird check           # credential sources
bird query-ids --fresh  # refresh when Twitter rotates IDs
bash
bird whoami          # 验证认证状态
bird check           # 查看凭证来源
bird query-ids --fresh  # 当Twitter更新ID时刷新

Smaug — Bookmark Archival

Smaug — 书签归档工具

Archives bookmarks/likes to organized markdown with AI categorization.
bash
cd ~/tools/smaug
npx smaug run                    # fetch + process with Claude
npx smaug fetch 20               # fetch only
npx smaug fetch --source likes   # likes instead of bookmarks
npx smaug run -t                 # track token costs
npx smaug status                 # check state
Output: 
bookmarks.md
, 
knowledge/tools/
, 
knowledge/articles/
将书签/点赞内容归档为结构化Markdown，并通过AI进行分类。
bash
cd ~/tools/smaug
npx smaug run                    # 抓取+使用Claude处理
npx smaug fetch 20               # 仅抓取内容
npx smaug fetch --source likes   # 抓取点赞内容而非书签
npx smaug run -t                 # 跟踪令牌成本
npx smaug status                 # 检查状态
输出文件：
bookmarks.md
, 
knowledge/tools/
, 
knowledge/articles/

Research Methodology

调研方法

For deep X research, follow this agentic loop:
  1. Decompose — Break topic into 2-3 search queries targeting different angles
  2. Search — Run each query with 
    --quick
    first to assess signal quality
  3. Refine — Narrow queries based on initial results (add 
    --from
    , 
    --quality
    , 
    --since
    )
  4. Thread — Follow high-value conversation threads for deeper context
  5. Deep-Dive — Re-run best queries with 
    --pages 3 --markdown --save
  6. Synthesize — Compile findings from saved markdown into analysis
Default to 
--quick
for exploratory queries. Use full mode only for confirmed-valuable searches.
针对X平台的深度调研，遵循以下智能循环流程：
  1. 分解 — 将话题拆分为2-3个不同角度的搜索查询
  2. 搜索 — 先使用
    --quick
    运行每个查询，评估信号质量
  3. 优化 — 根据初始结果缩小查询范围（添加
    --from
    , 
    --quality
    , 
    --since
    等参数）
  4. 追踪线程 — 跟进高价值对话线程以获取深层上下文
  5. 深度挖掘 — 使用
    --pages 3 --markdown --save
    重新运行最优查询
  6. 合成 — 将保存的Markdown中的发现整理成分析报告
对于探索性查询，默认使用
--quick
模式。仅对确认有价值的搜索使用完整模式。

Troubleshooting

故障排除

x-search: "X_BEARER_TOKEN not found"

x-search："X_BEARER_TOKEN not found"

Set token via env, 
~/.config/env/global.env
, or 
~/.claude/skills/twitter/.env
. Get one at console.x.com.
通过环境变量、
~/.config/env/global.env
或
~/.claude/skills/twitter/.env
设置令牌。可在console.x.com获取令牌。

bird: 403 Errors

bird：403错误

Browser cookies expired. Log into Twitter in browser, then 
bird check
.
浏览器Cookie已过期。在浏览器中登录Twitter，然后运行
bird check
。

bird: Query ID Errors

bird：查询ID错误

Twitter rotated internals. Run 
bird query-ids --fresh
.
Twitter更新了内部机制。运行
bird query-ids --fresh
。

Rate Limiting (429)

速率限制（429错误）

Wait for reset. x-search shows reset time. bird: wait a few minutes.
等待限制重置。x-search会显示重置时间。bird：等待几分钟后重试。

When to Use Which

工具选择指南

TaskToolWhy
Search tweets by topicx-searchOfficial API, cost-tracked, cached
Research a topic deeplyx-searchMulti-page, markdown output, save
Monitor specific accountsx-search watchlistBatch check with cost tracking
Post a tweet or replyx-search post/replyOfficial API, reliable, $0.01/post
Post with mediabirdFree, media upload support
Read a specific tweet/threadbird (free) or x-search (tracked)bird for quick reads, x-search for research
Check mentionsbirdFree, real-time
Archive bookmarkssmaugAI categorization, markdown output
Fetch bookmarks/likesbird + smaugSession-based access
任务工具原因
按话题搜索推文x-search官方API，成本可追踪，支持缓存
深度调研话题x-search多页搜索，Markdown输出，支持保存
监控特定账号x-search watchlist批量检查，成本追踪
发布推文或回复x-search post/reply官方API，可靠，每条0.01美元
发布带媒体的内容bird免费，支持媒体上传
读取特定推文/线程bird（免费）或x-search（可追踪）bird用于快速读取，x-search用于调研场景
查看提及内容bird免费，实时更新
归档书签smaugAI分类，Markdown输出
抓取书签/点赞内容bird + smaug基于会话的访问方式