Agent skill

Twitterapi Io Read

by kaitoInfra in kaitoInfra/twitterapi-io

Read-only skill for twitterapi.io — look up public X/Twitter data (tweets, user profiles, followers and followings, advanced search, replies, quotes, trends, lists, communities) through the…

MITAuto-check passedBackend & APIs

Install Twitterapi Io Read

skills CLI
$ npx skills add kaitoInfra/twitterapi-io --skill twitterapi-io-read -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kaitoInfra/twitterapi-io twitterapi-io-read --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kaitoInfra/twitterapi-io.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/twitterapi-io-read .claude/skills/twitterapi-io-read && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
twitterapi-io-read
GitHub stars
451
Token cost
~1.1k tokens
SKILL.md length
398 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Read-only skill for twitterapi.io — look up public X/Twitter data (tweets, user profiles, followers and followings, advanced search, replies, quotes, trends, lists, communities) through the…

  • The user wants to search
  • SKILL.md covers When to use this skill, Core facts, Security and Minimal example, plus 3 more sections
  • Calls curl; reaches api.twitterapi.io and mcp.twitterapi.io; needs TWITTERAPI_IO_KEY
  • Monitor public posts and accounts

What it does

Twitterapi Io Read is an agent skill from kaitoInfra/twitterapi-io. Read-only skill for twitterapi.io — look up public X/Twitter data (tweets, user profiles, followers and followings, advanced search, replies, quotes, trends, lists, communities) through the twitterapi.io REST API with a single x-api-key header. Use when the user wants to search, analyze or monitor public posts and accounts. Read-only: no posting, no account login, no credentials beyond the API key.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Social media posts and REST APIs. It works with X (Twitter). The licence is MIT.

When your agent uses it

  • The user wants to search
  • Monitor public posts and accounts

Example prompts

  • “/twitterapi-io-read”

Requirements

  • Python 3
  • A credential in YOUR_KEY
  • A credential in TWITTERAPI_IO_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit c11e39a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.twitterapi.io
    • mcp.twitterapi.io

    Also links to:

    • twitterapi.io
    • developer.x.com
    • docs.twitterapi.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TWITTERAPI_IO_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Twitterapi Io Read loads about 1.1k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 398 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kaitoInfra/twitterapi-io at commit c11e39a, republished under its MIT licence (© kaitoInfra). 398 words, ~1,133 tokens.

Download SKILL.mdSave it as .claude/skills/twitterapi-io-read/SKILL.md (or your agent's skills folder).
name
twitterapi-io-read
description
Read-only skill for twitterapi.io — look up public X/Twitter data (tweets, user profiles, followers and followings, advanced search, replies, quotes, trends, lists, communities) through the twitterapi.io REST API with a single x-api-key header. Use when the user wants to search, analyze or monitor public posts and accounts. Read-only: no posting, no account login, no credentials beyond the API key.

twitterapi.io (read-only)

Read-only skill maintained by the twitterapi.io team. It covers public X/Twitter data only: it never logs in to an X account, never handles cookies, passwords or proxies, and never posts, likes, follows or sends messages.

twitterapi.io is an independent third-party REST API for public X data, not affiliated with X Corp. If you need X's own API, the official one is at https://developer.x.com.

When to use this skill

  • Search posts with X search operators (from:, since_time:, min_faves:, lang: …)
  • Look up user profiles, followers, followings
  • Get a user's recent posts, replies, quote posts, retweeters, thread context
  • Trends, lists, communities
  • Build dashboards, research datasets or monitoring jobs on public data

Core facts

Base URLhttps://api.twitterapi.io
Auth headerx-api-key: YOUR_KEY (from https://twitterapi.io/dashboard)
Docshttps://docs.twitterapi.io
Pricingpay per call, see https://twitterapi.io/pricing
Hosted MCP serverhttps://mcp.twitterapi.io/mcp (12 read-only tools)

Security

Read the API key from the environment variable TWITTERAPI_IO_KEY. Never hardcode it, print it or commit it. If it is missing, ask the user to create one on the dashboard.

Minimal example

bash
curl -s "https://api.twitterapi.io/twitter/user/info?userName=jack" \
  -H "x-api-key: $TWITTERAPI_IO_KEY"
python
import os, requests

BASE = "https://api.twitterapi.io"
HEADERS = {"x-api-key": os.environ["TWITTERAPI_IO_KEY"]}

r = requests.get(f"{BASE}/twitter/tweet/advanced_search",
                 headers=HEADERS,
                 params={"query": "from:jack", "queryType": "Latest"},
                 timeout=30)
r.raise_for_status()
for t in r.json().get("tweets", []):
    print(t["createdAt"], t["text"][:80])

Read endpoints

Parameter names differ per endpoint (some camelCase, some snake_case). Copy them exactly as shown.

CapabilityMethodPath & key param
User by screen nameGET/twitter/user/info?userName=
Extended profileGET/twitter/user_about?userName=
Users by IDsGET/twitter/user/batch_info_by_ids?userIds=
Search usersGET/twitter/user/search?query=
Recent postsGET/twitter/user/last_tweets?userName= (or userId=)
MentionsGET/twitter/user/mentions?userName=
FollowersGET/twitter/user/followers?userName=&pageSize=200
FollowingsGET/twitter/user/followings?userName=
Posts by IDsGET/twitter/tweets?tweet_ids=
RepliesGET/twitter/tweet/replies?tweetId=
Quote postsGET/twitter/tweet/quotes?tweetId=
RetweetersGET/twitter/tweet/retweeters?tweetId=
Thread contextGET/twitter/tweet/thread_context?tweetId=
Advanced searchGET/twitter/tweet/advanced_search?query=&queryType=Latest
TrendsGET/twitter/trends?woeid=1
List postsGET/twitter/list/tweets?listId=
List membersGET/twitter/list/members?list_id=
Community postsGET/twitter/community/tweets?community_id=
Account balanceGET/oapi/my/info
Show full SKILL.md (132 more words)Show less

Patterns

Pagination

List endpoints return has_next_page and next_cursor. Pass next_cursor back as cursor; stop when has_next_page is false. Always set a page limit so a bug can't page forever.

Errors
  • 400 → a required parameter is missing or the search query is invalid (the response detail says what to fix)
  • 401 / 403 → missing or wrong x-api-key
  • 402 → out of credits; stop and tell the user to top up (don't retry)
  • 429 → rate-limited; retry with backoff
  • 5xx → transient; retry with backoff
Cost awareness

Each call is billed. Before a loop that could run long (all followers of a large account, months of search), estimate the number of calls and confirm with the user.

Anti-patterns

  • Don't normalise parameter names; copy them from the table
  • Don't retry on 402
  • Don't log or commit the API key

© kaitoInfra, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/twitterapi-io-read of kaitoInfra/twitterapi-io.

Open the folder on GitHubat commit c11e39a

Compare with similar skills

Twitterapi Io Read next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Twitterapi Io Read compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Twitterapi Io Read this skillkaitoInfra/twitterapi-io451—~1.1kAutomated safety check: PassMIT
X Twitter Scrapersickn33/agentic-awesome-skills47k1 repos~2.1kAutomated safety check: PassMIT
X Twitter Scrapergithub/awesome-copilot40k—~2.2kAutomated safety check: PassMIT
X Twitter Scraperdavila7/claude-code-templates33k—~1.8kAutomated safety check: PassMIT
X Twitter Scraperdavepoon/buildwithclaude3.6k—~2.2kAutomated safety check: PassMIT
Xtwitter Scrapermanagedcode/dotnet-skills486—~1.5kAutomated safety check: PassMIT

Similar skills

  • X Twitter Scraper

    sickn33/agentic-awesome-skills

    Use Xquik for X data workflows: tweet search, user lookup, follower export, media downloads, monitors, webhooks, REST API, MCP, SDK setup, and approval-gated account actions.

    47k GitHub starsUsed in 1 repo~2.1k tokens
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    github/awesome-copilot

    Official

    Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower…

    40k GitHub stars~2.2k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    davila7/claude-code-templates

    X API & Twitter scraper skill for AI coding agents. An agent skill from davila7/claude-code-templates.

    33k GitHub stars~1.8k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • X Twitter Scraper

    davepoon/buildwithclaude

    X (Twitter) data extraction and monitoring via Xquik: tweet search, user lookup, follower extraction, giveaway draws, trending topics, account monitoring with webhooks, reply/retweet/quote…

    3.6k GitHub stars~2.2k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Xtwitter Scraper

    managedcode/dotnet-skills

    Use XTwitterScraper when a .NET application needs typed access to Xquik's X automation REST API for tweet search, user lookup, posting workflows, extraction jobs, monitors, webhooks, or giveaway…

    486 GitHub stars~1.5k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • X API

    sundial-org/awesome-openclaw-skills

    Post to X (Twitter) using the official API with OAuth 1.0a. An agent skill from sundial-org/awesome-openclaw-skills.

    663 GitHub stars~598 tokensUpdated 7 mo ago
    Backend & APIsAuto-check passed

More from kaitoInfra/twitterapi-io

  • Twitterapi Io

    kaitoInfra/twitterapi-io

    Official skill for twitterapi.io — query Twitter/X data (tweets, profiles, followers, advanced search, trends, spaces, communities, lists) and perform authenticated actions (post, reply, like…

    451 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Twitterapi Io Read

What does Twitterapi Io Read do?

Read-only skill for twitterapi.io — look up public X/Twitter data (tweets, user profiles, followers and followings, advanced search, replies, quotes, trends, lists, communities) through the…. Twitterapi Io Read is an agent skill from kaitoInfra/twitterapi-io.io REST API with a single x-api-key header.

When should I use Twitterapi Io Read?

Twitterapi Io Read fits situations like: the user wants to search; monitor public posts and accounts.

How do I install Twitterapi Io Read in Claude Code?

Run `npx skills add kaitoInfra/twitterapi-io --skill twitterapi-io-read -a claude-code`. Or copy the skill folder (skills/twitterapi-io-read in kaitoInfra/twitterapi-io) into .claude/skills/twitterapi-io-read in your project. Claude Code loads it when a task matches its description.

How do I install Twitterapi Io Read in Codex?

Run `npx skills add kaitoInfra/twitterapi-io --skill twitterapi-io-read -a codex`. Or copy the skill folder (skills/twitterapi-io-read in kaitoInfra/twitterapi-io) into .agents/skills/twitterapi-io-read in your project. Codex loads it when a task matches its description.

Can I use Twitterapi Io Read in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kaitoInfra/twitterapi-io --skill twitterapi-io-read -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/twitterapi-io-read, .gemini/skills/twitterapi-io-read, .github/skills/twitterapi-io-read and .opencode/skills/twitterapi-io-read in your project.

What does Twitterapi Io Read need to run?

Going by SKILL.md and its folder, Twitterapi Io Read needs the command-line tools its instructions call (curl) and credentials named TWITTERAPI_IO_KEY. Our summary lists: Python 3; A credential in YOUR_KEY; A credential in TWITTERAPI_IO_KEY.

Does Twitterapi Io Read access the network?

SKILL.md names 5 domains. In commands or code: api.twitterapi.io and mcp.twitterapi.io; the agent is likely to contact these when it follows the instructions. As links in the text: twitterapi.io, developer.x.com and docs.twitterapi.io. This is read from the text; nothing was executed.

Is Twitterapi Io Read safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Twitterapi Io Read use?

Twitterapi Io Read is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Twitterapi Io Read use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Twitterapi Io Read?

Skills that share tags, products or a category with Twitterapi Io Read: X Twitter Scraper (sickn33/agentic-awesome-skills, 47k stars), X Twitter Scraper (github/awesome-copilot, 40k stars), X Twitter Scraper (davila7/claude-code-templates, 33k stars) and X Twitter Scraper (davepoon/buildwithclaude, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Twitterapi Io Read?

kaitoInfra (a GitHub user) maintains it in kaitoInfra/twitterapi-io, which has 451 GitHub stars. The repository was last updated on October 10, 2026.

Source: kaitoInfra/twitterapi-io on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.