mcpField
T
twitter

twitter

github.com/himself65生产力3.5k71 次安装5 天前更新
代码仓库

关于 twitter

通过 twitter-cli 进行 Twitter/X 金融研究的只读 Skill。它使用浏览器会话认证，可搜索和查看帖子、动态、个人资料、书签及列表。

主要功能

  1. 01按条件搜索帖子
  2. 02查看动态、书签和列表
  3. 03查看帖子与文章
  4. 04查看个人资料及动态
  5. 05输出结构化 JSON 或 YAML

适用场景

  1. 01跟踪股票或市场事件讨论
  2. 02查看分析师发布的内容
  3. 03监测某用户近期动态
  4. 04收集金融研究相关帖子

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/himself65/finance-skills --skill twitter

安装后在 Claude Code 中输入/twitter确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
commands.md
schema.md

详细介绍

Twitter Skill（只读）

使用 twitter-cli 读取 Twitter/X，以进行金融研究。该命令行工具通过浏览器 Cookie 身份验证访问 Twitter。

此技能为只读。 它专为金融研究而设计：搜索市场讨论、阅读分析师推文、追踪市场情绪，以及监控 Twitter/X 上的金融新闻。不支持发帖、点赞、转推、回复或任何写入操作。

重要提示：此工具使用浏览器会话 Cookie。无需 API 密钥——它通过已登录的浏览器会话（Chrome、Arc、Edge、Firefox、Brave）进行身份验证。

第 1 步：确认已安装并完成 twitter-cli 身份验证

当前环境状态：

!`(command -v twitter && twitter status --yaml 2>&1 | head -5 && echo "AUTH_OK" || echo "AUTH_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

如果上述状态显示 AUTH_OK，请跳到第 2 步。如果显示 NOT_INSTALLED，请先安装：

# Install (requires Python 3.10+)
uv tool install twitter-cli

如果显示 AUTH_NEEDED，请引导用户：

身份验证方式

方式 A：提取浏览器 Cookie（推荐）

确保用户已在 Arc/Chrome/Edge/Firefox/Brave 中登录 x.com。twitter-cli 会自动提取 Cookie。使用以下命令验证：

twitter whoami

Chrome 多配置文件：系统会自动扫描所有配置文件。指定某个配置文件的方法：

TWITTER_CHROME_PROFILE="Profile 2" twitter feed

方式 B：环境变量

export TWITTER_AUTH_TOKEN="<auth_token from browser>"
export TWITTER_CT0="<ct0 from browser>"
twitter whoami
常见身份验证问题
症状解决方法
No Twitter cookies found在浏览器中登录 x.com，或设置环境变量
Cookie expired (401/403)重新登录 x.com，然后重试
Unable to get key for cookie decryption（macOS）对于 SSH，请运行 security unlock-keychain ~/Library/Keychains/login.keychain-db；或者在钥匙串访问中允许 Terminal 访问

第 2 步：确认用户的需求

将用户的请求与以下读取命令匹配，然后使用 references/commands.md 中对应的命令。

用户请求命令关键标志
身份验证检查twitter status--yaml
我是谁twitter whoami--json、--yaml
首页动态 / 时间线twitter feed-t following、--max N、--full-text、--filter
搜索推文twitter search "QUERY"-t Latest、--from USER、--since DATE、--lang、--exclude retweets、--has links、--max N
书签twitter bookmarks--max N、--full-text
查看指定推文twitter tweet TWEET_ID_OR_URL--full-text
打开上一个列表中的推文twitter show N--full-text、--json
Twitter 文章twitter article ID_OR_URL--markdown、--output FILE、--json
列表时间线twitter list LIST_ID--full-text、--max N
用户资料twitter user USERNAME--json
用户的推文twitter user-posts USERNAME--max N、--full-text、-o FILE
用户的点赞twitter likes USERNAME仅限本人账号（自 2024 年 6 月起为私有）
粉丝twitter followers USERNAME--max N
正在关注twitter following USERNAME--max N

第 3 步：执行命令

通用模式
# Use --yaml for structured output, -c for compact (token-efficient)
twitter feed --yaml --max 20
twitter -c feed --max 10              # Compact: ~80% fewer tokens than --json

# Searching for financial topics
twitter search "$AAPL earnings" -t Latest --max 10 --full-text --yaml
twitter search "Fed rate decision" --since 2026-03-01 --max 20 --yaml
twitter search "market crash" --exclude retweets --has links --max 15
关键规则
  1. 先检查身份验证——运行 twitter status --yaml，然后再运行其他命令
  2. 以编程方式处理数据时，使用 --yaml 或 --json 获取结构化输出
  3. 需要节省令牌时（LLM 上下文），使用 -c / --compact
  4. 用户需要完整推文内容时，使用 --full-text（丰富表格中的文本默认会被截断）
  5. 使用 --max N 限制结果数量——除非用户要求更多，否则从 10–20 条开始
  6. 搜索时使用筛选条件——--from、--since、--lang、--exclude retweets、--has links
  7. 推文 ID 和 URL 均可使用：twitter tweet 1234567890 或 twitter tweet https://x.com/user/status/1234567890
  8. 使用 twitter show N 引用最近一次列表输出中的第 N 条推文
  9. 绝不执行写入操作——此技能为只读；不得发帖、点赞、转推、回复、引用、关注或删除
输出标志（所有读取命令）
标志用途
--jsonJSON 输出
--yamlYAML 输出（非 TTY 时为默认格式）
--full-text显示完整推文文本（仅限富表格）
-c / --compact精简字段，非常适合用于 LLM 上下文
-o FILE / --output FILE将输出保存到文件
--input FILE从先前保存的 JSON 中读取
结构化输出封装

所有 --yaml 和 --json 输出均使用此封装（参见 references/schema.md）：

ok: true
schema_version: "1"
data: ...          # tweet/user lists or single objects

错误响应：

ok: false
schema_version: "1"
error:
  code: api_error
  message: "..."

第 4 步：呈现结果

获取数据后，以清晰的方式呈现，便于财务研究：

  1. 总结关键内容 — 突出与用户财务研究最相关的推文
  2. 注明来源 — 显示 @username、推文文本和互动指标（点赞、转发）
  3. 提供推文 ID/URL，方便用户阅读完整讨论串
  4. 对于搜索结果，按相关性分组，并突出关键主题、情绪或市场信号
  5. 对于用户个人资料，呈现粉丝数、简介和近期值得关注的动态
  6. 标记情绪 — 指出看涨/看跌情绪、共识观点与逆向观点
  7. 将 Cookie 视为机密 — 切勿将 Cookie 值输出到 stdout

第 5 步：诊断

如果遇到问题，请运行：

twitter doctor

报告版本、操作系统、浏览器检测结果、钥匙串状态和 Cookie 提取结果。

如需对任何命令进行详细诊断，请添加 -v。

错误参考

错误原因解决方法
No Twitter cookies found未通过身份验证在浏览器中登录 x.com，或设置环境变量
HTTP 401/403Cookie 已过期重新登录 x.com，然后重试
HTTP 404QueryId 轮换重试（内置自动回退）
HTTP 429请求频率受限等待 15 分钟以上，然后重试

代理配置

export TWITTER_PROXY=http://127.0.0.1:7890
# or
export TWITTER_PROXY=socks5://127.0.0.1:1080

参考文件

  • references/commands.md — 完整的读取命令参考，包含所有标志、研究工作流和用法示例
  • references/schema.md — 结构化输出架构文档

需要精确的命令语法、研究工作流模式或架构详情时，请阅读参考文件。

评论

支持 Markdown