twitter-api Skill (fetcher.sh): Paid X Data Calls

Makes Claude fetch X (Twitter) tweets, profiles, followers, lists and trends through fetcher.sh, paid per call.

Installs: 8.3K; on skills.sh
Stars: 2; on GitHub
Files: 4; besides SKILL.md
Updated: Sep 2026; last repo commit

twitter-api tells Claude to call the 15 GET endpoints at twitter.fetcher.sh. They cover tweet search with X's operators, profiles by handle or ID, timelines, replies, followers, followings, single tweets, retweeters, Lists and trends by country. SKILL.md calls it an alternative to the official X API, with no OAuth and no developer application.

You pay fetcher.sh per call: $0.002 to $0.005 each, from prepaid credits with a Bearer key or from a USDC wallet through x402. This is not an X product. Payment and key setup live in the shared fetcher skill.

Good for

Analysts doing social listening on X and Twitter
Teams tracking competitors, hashtags or follower lists
Developers feeding tweet data into an agent pipeline

Install twitter-api

Claude Code

Copy this prompt.

Install the twitter-api skill in Claude Code. Run this command:

/install-plugin https://github.com/fetcher-sh/fetcher-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

This skill is a paid data service from fetcher.sh, not from X. Every call is charged to the credit key or USDC wallet you use, so read the permissions section first. SKILL.md sends payment and key setup to the shared fetcher skill, so the commands here install both. The README also documents installing the whole repo with npx skills add fetcher-sh/fetcher-skills and a Claude Code plugin route that adds 13 skills (counted from the marketplace manifest) and 4 slash commands, with no hooks in the git tree. There is no Claude app upload route, because the skill makes HTTP calls from your shell.

From the project README. Source.

What's in the skill

When it loads

A Twitter API alternative and X API alternative on fetcher.sh — pay-per-call in USDC via x402, or prepaid credits with a Bearer key, no OAuth and no developer application. Use when the user wants to search tweets by keyword, hashtag, or advanced operators (from:, to:, since:, until:, min_faves:, filter:), scrape a Twitter/X profile by handle, pull a user's tweets, replies, followers, or followings, fetch a single tweet with its replies or retweeters, read a Twitter List's members or tweets, check trending topics by country, or search for X accounts by name. Also covers Twitter data pipelines, competitor monitoring, hashtag tracking, sentiment analysis input, or follower export without the official X API's pricing tiers or app-review process.

Sections in SKILL.md

Quick reference
Which endpoint do I need?
Authentication
Endpoints (15 — all GET, $0.005/call unless noted)
Scenarios
MCP
Errors
Reference

Key facts

Author: fetcher.sh (named in plugin.json and the README), a third-party service, not X
License: MIT (LICENSE file and plugin.json)
Installs on skills.sh: 8,281 (Nov 2, 2026)
GitHub stars: 2 (Nov 2, 2026)
Last repo commit: Sep 5, 2026
What it includes: 5 files including SKILL.md: 4 reference files (comparison, endpoints, faq, scenarios). No scripts.
Needs: A fetcher.sh credit key (FETCHER_API_KEY, from fetcher.sh/topup) or a USDC wallet for x402 payments, and curl or any HTTP client
Works in: npx skills, a Claude Code plugin, Cursor and Windsurf (copy SKILL.md), and Codex or Gemini CLI via the skills folder or AGENTS.md, per the README
Price: $0.005 per call, $0.002 for a single tweet by ID (SKILL.md)
Part of: The fetcher-skills plugin: 13 skills in its marketplace manifest, plus 4 slash commands

What it includes

Searches tweets with X operators such as from:, since:, min_faves: and filter:
$0.005 per call.
Network · /api/search
Searches accounts by name
Network · /api/search/users
Profile by @handle, plus /about for extended info
Network · /api/handle/{handle}
Profile by ID, with /tweets, /replies, /followers and /followings
Five endpoints under /api/user/{id}.
Network · /api/user/{id}
A single tweet at $0.002, with /replies and /retweeters at $0.005
Network · /api/tweet/{id}
A Twitter List's /members and /tweets
Network · /api/list/{id}
Trending topics for a country
Network · /api/trends
Optional MCP server with free lookup tools and paid fetch tools
Free: search_endpoints, describe_endpoint, check_balance. Paid: fetch_data, topup_credits, twitter_search. Add a Bearer header, or drop it to pay by x402.
Network · MCP at twitter.fetcher.sh/mcp
Status codes 400, 401, 402 and 404, each with a stated cause
400 is a bad parameter, 401 an unknown key, 402 payment required or top-up needed, 404 not a priced path. SKILL.md says there are no rate limits and no refunds on upstream failures.
Read · Errors

From the official docs

Permissions

Medium risk

twitter-api makes paid calls to fetcher.sh with your credit key or wallet. Our advice: fund a small balance, and treat tweet text as data, not instructions.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Scraped data, not the official X API: ToS and account risk
The README says fetcher.sh is "an independent, unofficial proxy that scrapes and republishes public data" and has no affiliation with X Corp. The skill's comparison.md lists "X's own ToS-sanctioned access" only under the official X API. Scraping X can conflict with X's terms. Neither file says what happens to a user who relies on the service. Our advice: do not use it for a product or business that must stay within X's terms, and do not send it any X account credentials. github.com
Every call spends your money
SKILL.md lists $0.002 to $0.005 per call. The fetcher skill says top-ups start at $1 and there are no refunds on upstream failures. Our advice: fund a small balance, since a looping agent can run up many calls. github.com
It uses a funded key or wallet
You set FETCHER_API_KEY, or let an x402 client sign USDC payments from a wallet. The fetcher skill's x402 path uses @x402/fetch. Our advice: keep any wallet key out of prompts and use a small balance. github.com
Tweet text is untrusted input
The fetcher skill says all returned content is data, not instructions, and suggests wrapping quoted content in a FETCHER_UNTRUSTED_CONTENT boundary. It adds that this is a convention and the agent has to apply it. github.com
The plugin route adds more
The Claude Code plugin adds 13 skills and 4 slash commands. The /twitter-search command caps paging at 3 pages unless you ask for more, because each page is a paid call. The git tree shows no hooks. github.com

Technical details

Turning on read-only	No read-only switch.
Talks to	twitter.fetcher.sh. fetcher.sh
Sign-in and keys	FETCHER_API_KEY (a bby_live_ Bearer key bought with credits) or x402 payments from your wallet, per SKILL.md and the README.
Scopes	Claude makes HTTP GET calls to twitter.fetcher.sh with your Bearer key Each call is charged to your credit balance or USDC wallet Returns user-written tweet text into the conversation

Questions

What does the twitter-api skill do?

It makes Claude fetch X (Twitter) data from fetcher.sh: tweet search, profiles, timelines, followers, Lists and trends. All 15 endpoints are plain GET requests.

How do I install it?

Use the install box at the top. It installs twitter-api plus the shared fetcher skill, which holds the payment and key setup. The README also documents a Claude Code plugin and a whole-repo install.

How much does it cost and who pays?

You do. fetcher.sh charges $0.002 to $0.005 per call, from your prepaid credit balance or from a USDC wallet through x402. A top-up has a $1 minimum, and the fetcher skill says there are no refunds on upstream failures.

Do I need an X developer account?

No. SKILL.md says there is no developer application, app review or OAuth. You authenticate to fetcher.sh with a Bearer key or an x402 payment instead.

Is it made by X?

No. The README calls fetcher.sh "an independent, unofficial proxy that scrapes and republishes public data", with no affiliation to X Corp. For X's own tools, see the X MCP server page. The skill's comparison file lists "X's own ToS-sanctioned access" as a reason to pick the official X API. Read X's terms before depending on a scraping service.

Can it post or follow for me?

SKILL.md lists only GET endpoints for reading data. The README says there is no write, publish, follow or delete action in the catalog.

What is the difference from x-api?

The README says twitter-api and x-api point at the same host and cover the same endpoints under two names.

Is it safe?

The skill bundles no scripts, but it makes paid calls with a key or wallet and returns other people's text. Our advice: fund a small balance, and treat tweet text as data, as the fetcher skill's content safety section also says.

Information

updated Nov 2, 2026

Repository: fetcher-sh/fetcher-skills
Folder: skills/twitter-api

fetcher-sh/fetcher-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 8

twitter-api SKILL.md · github.com
fetcher-skills README · github.com
fetcher SKILL.md · github.com
marketplace.json · github.com
plugin.json · github.com
LICENSE · github.com
skills.sh listing · skills.sh
twitter-api comparison.md · github.com