# X Twitter Research

> Export bulk X/Twitter datasets as downloadable files — follower and following lists, everyone who replied to or reposted or quoted a post, full threads, likers, mentions, user media, community members, list members, and people or tweet search results, across 23 extractors. Trigger whenever the user wants X data in bulk or as a file: exporting followers, analysing who engaged with a post, auditing…

- **Type:** Skill
- **Install:** `agentstack add skill-lnvestor-twitr-skills-x-twitter-research`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [lnvestor](https://agentstack.voostack.com/s/lnvestor)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [lnvestor](https://github.com/lnvestor)
- **Source:** https://github.com/lnvestor/twitr-skills/tree/main/skills/x-twitter-research
- **Website:** twitr.sh

## Install

```sh
agentstack add skill-lnvestor-twitr-skills-x-twitter-research
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# X research — bulk exports

Extractions run **asynchronously**: the call returns a claim check, you poll, and you get a
**download URL** — not inline rows. That's deliberate; a 5,000-row dataset would swamp context.

## Run one

```
POST https://twitr.sh/api/tools/x_extract
Idempotency-Key: 
{ "tool": "follower_explorer", "targetUsername": "vercel", "resultsLimit": 500 }
```

→ `{ "snapshot_id": "sd_…", "status": "pending", "status_url": "/api/snapshots/sd_…" }`

Then poll (free, wallet-signed) until ready:

```
GET https://twitr.sh/api/snapshots/sd_…
→ { "status": "ready", "record_count": 500, "download_url": "https://…" }
```

## Picking the target field

The `tool` decides which target you must supply — getting this wrong is the most common error:

| Target field | Used by |
|---|---|
| `targetUsername` | follower / following / verified-follower / post / mention / likes / media |
| `targetTweetId` | reply / repost / quote / thread / article / favoriters |
| `targetCommunityId` | community members / moderators / posts |
| `targetListId` | list members / followers |
| `targetSpaceId` | space extractors |
| `searchQuery` | `people_search`, `tweet_search_extractor` |

## Gotchas

- **`resultsLimit` is mandatory and it is the price.** Billed per returned record at ~$0.0012, so
  5,000 records ≈ $6. **Quote the cost before running, and confirm above ~$1.**
- **`article_extractor` bills 5× per record.** Budget accordingly.
- **`Idempotency-Key` is required.** Retrying without the same key starts — and charges for — a
  second job.
- **The response is a claim check, not data.** Don't try to read rows from the create response.
- **Don't poll in a tight loop.** Hand the user the `snapshot_id` and check when they ask;
  spinning burns tokens for no benefit. Large jobs take minutes.
- **When ready, the data is behind `download_url`.** Fetch and summarise, or hand over the URL —
  never paste a large dataset into context.
- **`GET /api/snapshots`** lists every dataset this wallet has paid for, so past exports are free
  to re-find.

## Avoid

- Don't export 5,000 records when 200 answers the question. Sample first, then scale.
- Don't use extractions to build a follow list — automated following is prohibited by X and
  unsupported by these skills (see `x-twitter-publish`).
- Don't re-run an export you've already paid for; check `/api/snapshots` first.

Full API: https://twitr.sh/skill.md · https://twitr.sh/docs

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [lnvestor](https://github.com/lnvestor)
- **Source:** [lnvestor/twitr-skills](https://github.com/lnvestor/twitr-skills)
- **License:** MIT
- **Homepage:** twitr.sh

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-lnvestor-twitr-skills-x-twitter-research
- Seller: https://agentstack.voostack.com/s/lnvestor
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.