twitter-query

Query X/Twitter via twitterapi.io read-only APIs by account (user timeline) or by keyword (advanced search). Outputs structured JSON; no LLM, no trend scoring. Use when the user asks for tweets from a handle, user timeline, keyword/hashtag/cashtag search, or 推特/X 推文查询.

3,891 stars

byopenclaw

View on GitHub Installation ↓

Best use case

twitter-query is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Teams using twitter-query should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/twitter-query/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/alexander10011/twitter-query/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/twitter-query/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How twitter-query Compares

Feature / Agent	twitter-query	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

AI Agents for Marketing

Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.

AI Agents for Startups

Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.

AI Agents for Coding

Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.

SKILL.md Source

# Twitter / X 推文查询（只读）

通过 [twitterapi.io](https://docs.twitterapi.io/introduction) 拉取推文：**按账号**或**按关键词**，输出 **JSON**。不集成 LLM，不做趋势榜/热度建模。

## 环境

- `TWITTER_API_KEY`：必填（HTTP Header `X-API-Key`）。
- `TWITTER_API_BASE`：可选，默认 `https://api.twitterapi.io`。

## OpenClaw / ClawHub 安装

在已支持 Skills 的客户端中（以仓库发布名为准，示例为 `alexander10011/twitter-query`）：

```bash
npx skills add alexander10011/twitter-query
```

安装后，在**技能包根目录**下执行脚本（路径以实际克隆位置为准）。

## 脚本路径（仓库根目录）

| 能力 | 命令 |
|------|------|
| 某用户时间线 | `python3 scripts/query_by_user.py USERNAME [选项]` |
| 关键词高级搜索 | `python3 scripts/query_by_keyword.py "查询字符串" [选项]` |

### 按账号

```bash
export TWITTER_API_KEY="你的key"
python3 scripts/query_by_user.py VitalikButerin --max-pages 5
python3 scripts/query_by_user.py someuser --include-replies --max-pages 10
```

- 接口：`GET /twitter/user/last_tweets`（[文档](https://docs.twitterapi.io/api-reference/endpoint/get_user_last_tweets)），`cursor` 分页，每页最多约 20 条。
- 时间范围由分页量间接限制；需要「近 N 天」可对返回的 `createdAt` 再过滤。

### 按关键词

```bash
python3 scripts/query_by_keyword.py '$BTC min_faves:5' --query-type Latest --max-pages 3
python3 scripts/query_by_keyword.py 'from:elonmusk since:2026-03-01_00:00:00_UTC' --query-type Top
```

- 接口：`GET /twitter/tweet/advanced_search`（[文档](https://docs.twitterapi.io/api-reference/endpoint/tweet_advanced_search)）。
- `queryType`：`Latest` 或 `Top`；默认 `Latest`。
- 语法参考：[twitter-advanced-search](https://github.com/igorbrigadir/twitter-advanced-search)。

## 输出

脚本向 **stdout** 打印 JSON（`utf-8`），含 `meta` 与 `tweets`。

## Agent 工作方式

1. 确认已设置 `TWITTER_API_KEY`。
2. 选择 `query_by_user` 或 `query_by_keyword`，运行脚本。
3. 若需中文摘要或观点归纳，在**当前对话模型内**完成，本 Skill 不调用外部总结 API。

## 许可证

MIT，见 [LICENSE](LICENSE)。

Related Skills

Twitter Command Center (Search + Post)

3891

from openclaw/skills

Searches and reads X (Twitter): profiles, timelines, mentions, followers, tweet search, trends, lists, communities, and Spaces. Publishes posts after the user completes OAuth in the browser. Use when the user asks about Twitter/X data, social listening, or posting without sharing account passwords.

Social Media

gold-price-query

3891

from openclaw/skills

This skill retrieves real-time precious metal prices (gold, silver, platinum, palladium, etc.) from https://i.jzj9999.com/quoteh5. It provides bid/ask prices, daily high/low prices, and price trends for 20+ metal types.

Data & Research

x-twitter-poster

3891

from openclaw/skills

X (Twitter) 发推 Skill。使用 Playwright 连接用户已登录的 Chrome 浏览器，自动填写并发送推文。适用场景： - 用户要求"发推"、"发一条推"、"发推文"、"发推特" - 用户要求"帮我发一条关于 XX 的推" - 用户要求"发一条推文，内容是..." 核心能力： - 连接用户 Chrome 浏览器（CDP 模式） - 继承用户的登录状态 - 跨平台支持：Mac (Meta+Enter) / Windows/Linux (Control+Enter) ⚠️ 安全要求： - 仅在信任代码时启用 CDP 端口 - 建议使用单独 Chrome 账号测试 - 可配置 X_USERNAME 环境变量

Content & Documentation

X/Twitter Research Skill

3891

from openclaw/skills

Research trending topics, ideas, and conversations on X (Twitter) using twitterapi.io.

Data & Research

twittershots

3891

from openclaw/skills

Generate high-quality screenshots of Twitter/X posts using the TwitterShots API. Use when the user wants to: capture a tweet as an image, screenshot a tweet, generate tweet image, convert tweet to PNG/SVG/HTML, create tweet screenshot for social media (Instagram, TikTok), or mentions "TwitterShots", "tweet screenshot", "capture tweet", "tweet image". Triggers on tweet URLs (twitter.com/*/status/* or x.com/*/status/*) or tweet IDs. Default to format=png and theme=light without asking follow-up questions; if the user explicitly provides format and/or theme, use the user-provided values.

twitter-api-alternative

3891

from openclaw/skills

Twitter API Alternative — Search 1B+ tweets with natural language queries, boolean filters, and one-click CSV exports (up to 64K rows). Look up profiles, find users by topic, and track conversations. No developer account needed, no complex OAuth setup — 2-minute setup via Xpoz MCP.

stock-query

3891

from openclaw/skills

查询全球主要市场股票实时行情：A 股、港股、美股，以及场内 ETF、场外基金、主要指数。需要：curl（HTTP 请求）、iconv（GBK→UTF-8 转码）。 Use when: 用户要求查询股价、基金净值、ETF 价格、大盘指数，或需要计算持仓市值时。 NOT for: 加密货币、期货、期权、外汇。