# Send TwitterApi Research to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "twitterapi-research-skill", "name": "TwitterApi Research", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/blascokoa/twitterapi-research-skill", "canonicalUrl": "https://clawhub.ai/blascokoa/twitterapi-research-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/twitterapi-research-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twitterapi-research-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "lib/api.ts", "lib/cache.ts", "lib/format.ts", "package.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "twitterapi-research-skill", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-10T07:55:41.365Z", "expiresAt": "2026-05-17T07:55:41.365Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twitterapi-research-skill", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twitterapi-research-skill", "contentDisposition": "attachment; filename=\"twitterapi-research-skill-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "twitterapi-research-skill" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/twitterapi-research-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/twitterapi-research-skill", "downloadUrl": "https://openagent3.xyz/downloads/twitterapi-research-skill", "agentUrl": "https://openagent3.xyz/skills/twitterapi-research-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/twitterapi-research-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/twitterapi-research-skill/agent.md" } } ``` ## Documentation ### X Research General-purpose agentic research over X/Twitter. Decompose any research question into targeted searches, iteratively refine, follow threads, deep-dive linked content, and synthesize into a sourced briefing. For twitterapi.io API details (endpoints, operators, response format): read references/x-api.md. ### CLI Tool All commands run from this skill directory: cd ~/clawd/skills/x-research source ~/.config/env/global.env # needs TWITTERAPI_IO_KEY ### Search bun run x-search.ts search "" [options] Options: --sort likes|impressions|retweets|recent — sort order (default: likes) --since 1h|3h|12h|1d|7d — time filter (default: last 7 days). Also accepts minutes (30m) or ISO timestamps. --min-likes N — filter by minimum likes --min-impressions N — filter by minimum impressions --pages N — pages to fetch, 1-25 (default: 5, ~20 tweets/page) --limit N — max results to display (default: 15) --quick — quick mode: 1 page, max 10 results, auto noise filter (-is:retweet -is:reply), 1hr cache, cost summary --from — shorthand for from:username in query --quality — filter low-engagement tweets (≥10 likes, post-hoc) --no-replies — exclude replies --save — save results to ~/clawd/drafts/x-research-{slug}-{date}.md --json — raw JSON output --markdown — markdown output for research docs Auto-adds -is:retweet unless query already includes it. All searches display estimated API cost. Note: twitterapi.io search covers full archive (not limited to 7 days). Time filtering uses since: operator in the query. Examples: bun run x-search.ts search "BNKR" --sort likes --limit 10 bun run x-search.ts search "from:frankdegods" --sort recent bun run x-search.ts search "(opus 4.6 OR claude) trading" --pages 2 --save bun run x-search.ts search "$BNKR (revenue OR fees)" --min-likes 5 bun run x-search.ts search "BNKR" --quick bun run x-search.ts search "BNKR" --from voidcider --quick bun run x-search.ts search "AI agents" --quality --quick ### Profile bun run x-search.ts profile [--count N] [--replies] [--json] Fetches recent tweets from a specific user (excludes replies by default). ### Thread bun run x-search.ts thread [--pages N] Fetches full conversation thread by root tweet ID. ### Single Tweet bun run x-search.ts tweet [--json] ### Watchlist bun run x-search.ts watchlist # Show all bun run x-search.ts watchlist add [note] # Add account bun run x-search.ts watchlist remove # Remove account bun run x-search.ts watchlist check # Check recent from all Watchlist stored in data/watchlist.json. Use for heartbeat integration — check if key accounts posted anything important. ### Cache bun run x-search.ts cache clear # Clear all cached results 15-minute TTL. Avoids re-fetching identical queries. ### Research Loop (Agentic) When doing deep research (not just a quick search), follow this loop: ### 1. Decompose the Question into Queries Turn the research question into 3-5 keyword queries using X search operators: Core query: Direct keywords for the topic Expert voices: from: specific known experts Pain points: Keywords like (broken OR bug OR issue OR migration) Positive signal: Keywords like (shipped OR love OR fast OR benchmark) Links: url:github.com or url: specific domains Noise reduction: -is:retweet (auto-added), add -is:reply if needed Crypto spam: Add -airdrop -giveaway -whitelist if crypto topics flooding ### 2. Search and Extract Run each query via CLI. After each, assess: Signal or noise? Adjust operators. Key voices worth searching from: specifically? Threads worth following via thread command? Linked resources worth deep-diving with web_fetch? ### 3. Follow Threads When a tweet has high engagement or is a thread starter: bun run x-search.ts thread ### 4. Deep-Dive Linked Content When tweets link to GitHub repos, blog posts, or docs, fetch with web_fetch. Prioritize links that: Multiple tweets reference Come from high-engagement tweets Point to technical resources directly relevant to the question ### 5. Synthesize Group findings by theme, not by query: ### [Theme/Finding Title] [1-2 sentence summary] - @username: "[key quote]" (NL, NI) [Tweet](url) - @username2: "[another perspective]" (NL, NI) [Tweet](url) Resources shared: - [Resource title](url) — [what it is] ### 6. Save Use --save flag or save manually to ~/clawd/drafts/x-research-{topic-slug}-{YYYY-MM-DD}.md. ### Refinement Heuristics Too much noise? Add -is:reply, use --sort likes, narrow keywords Too few results? Broaden with OR, remove restrictive operators Crypto spam? Add -$ -airdrop -giveaway -whitelist Expert takes only? Use from: or --min-likes 50 Substance over hot takes? Search with has:links ### Heartbeat Integration On heartbeat, can run watchlist check to see if key accounts posted anything notable. Flag to Frank only if genuinely interesting/actionable — don't report routine tweets. ### File Structure skills/x-research/ ├── SKILL.md (this file) ├── x-search.ts (CLI entry point) ├── lib/ │ ├── api.ts (twitterapi.io wrapper: search, thread, profile, tweet) │ ├── cache.ts (file-based cache, 15min TTL) │ └── format.ts (Telegram + markdown formatters) ├── data/ │ ├── watchlist.json (accounts to monitor) │ └── cache/ (auto-managed) └── references/ └── x-api.md (twitterapi.io endpoint reference) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: blascokoa - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-10T07:55:41.365Z - Expires at: 2026-05-17T07:55:41.365Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/twitterapi-research-skill) - [Send to Agent page](https://openagent3.xyz/skills/twitterapi-research-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/twitterapi-research-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/twitterapi-research-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/twitterapi-research-skill)