OpenParable
Skip to content
← Back to skills

Twitter

Apps & Automation
twitter

Twitter is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when user asks to "search Twitter", "read a tweet", "check my bookmarks", "find mentions", "get tweets from a list", "see who I follow", "extract tweets", or needs programmatic access to X/Twitter for research and information synthesis. Handles reading, searching, bookmarks, lists, and social graph queries.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/integration/twitter-gupsammy-claude-setup-fd52d204/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/twitter, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Twitter / X Research & Extraction

Programmatic access to Twitter/X via bird CLI. Primary use: search, read, extract, and synthesize information.

Core Commands

Reading & Threads

bird read <url-or-id>           # Single tweet
bird read <url> --json          # JSON output for processing
bird thread <url>               # Full conversation thread
bird replies <url> -n 20        # Replies to a tweet

Search

bird search "query" -n 10       # Search tweets
bird search "from:user topic"   # User-specific search
bird search "query" --json      # JSON for processing

Bookmarks & Likes

bird bookmarks                  # Your saved tweets
bird bookmarks -n 50 --json     # Bulk export
bird likes                      # Your liked tweets
bird unbookmark <url>           # Remove bookmark

Lists

bird lists                      # Your lists
bird list-timeline <list-id>    # Tweets from a list

Social Graph

bird following                  # Who you follow
bird followers                  # Who follows you
bird mentions                   # Tweets mentioning you

Extraction Workflows

Save tweets to file

bird search "topic" -n 50 --json > tweets.json
bird bookmarks --json > bookmarks.json
bird thread <url> --json > thread.json

Synthesize from search

  1. bird search "topic" -n 20 --json > results.json
  2. Read results.json
  3. Extract key insights, summarize themes

Export bookmarks for review

  1. bird bookmarks -n 100 --json > bookmarks.json
  2. Parse and categorize by topic
  3. Create summary or reading list

Auth & Troubleshooting

Check auth status:

bird whoami                     # Current account
bird check                      # Credential sources

Auth sources (checked in order):

  • Browser cookies (Firefox/Chrome)
  • SWEETISTICS_API_KEY env var
  • Explicit --auth-token and --ct0 flags

Common issues:

  • Rate limits: Wait and retry; reduce -n count
  • Auth expired: Re-login to Twitter in browser, cookies auto-refresh
  • No results: Check query syntax; try broader terms

Output Formats

  • Default: Human-readable with emoji
  • --plain: Stable text output, no emoji/color
  • --json: Machine-readable for processing
  • --json-full: Includes raw API response

Always use --json when extracting for synthesis.