# Send Twitter/X scraper with Apify actors 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": "twitter-x-apify-actors",
    "name": "Twitter/X scraper with Apify actors",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/hundevmode/twitter-x-apify-actors",
    "canonicalUrl": "https://clawhub.ai/hundevmode/twitter-x-apify-actors",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/twitter-x-apify-actors",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twitter-x-apify-actors",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "agents/openai.yaml",
      "references/actor-contracts.md",
      "references/troubleshooting.md",
      "requirements.txt"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/twitter-x-apify-actors"
    },
    "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/twitter-x-apify-actors",
    "downloadUrl": "https://openagent3.xyz/downloads/twitter-x-apify-actors",
    "agentUrl": "https://openagent3.xyz/skills/twitter-x-apify-actors/agent",
    "manifestUrl": "https://openagent3.xyz/skills/twitter-x-apify-actors/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/twitter-x-apify-actors/agent.md"
  }
}
```
## Documentation

### Overview

This skill runs a reliable actor-based pipeline for Twitter/X lead collection using Apify. It extracts a username from an X/Twitter link, runs a follower/following actor, optionally runs an email actor, and returns normalized rows for outreach workflows.

Use this skill when a user asks to:

collect followers/following from X via Apify actors
enrich collected usernames with emails
convert profile links to actor-ready usernames
build JSON/webhook payloads for n8n or API endpoints

Default actor IDs in this skill:

Followers actor: bIYXeMcKISYGnHhBG
Email actor: mSaHt2tt3Z7Fcwf0o

### Quick Workflow

Parse input target (https://x.com/..., https://twitter.com/..., or @username).
Build follower actor payload using collectType and limit.
Run follower actor and normalize usernames.
If enrichment is enabled, run email actor and merge results.
Return final rows + summary metrics.

### Execution Rules

Prefer script execution for reliability: use scripts/apify_twitter_actors.py.
Keep actor IDs configurable, but default to the IDs above.
Always validate collectType (followers, following, both) and positive limit.
If email enrichment is disabled, skip email actor entirely.
Never hardcode the Apify token in outputs. Use env APIFY_TOKEN or explicit CLI argument.

### Authentication (Apify token)

Users can provide the Apify API token in two supported ways.

### Option A: Environment variable (recommended)

export APIFY_TOKEN='apify_api_xxx'
python3 scripts/apify_twitter_actors.py run-pipeline \\
  --target 'https://x.com/elonmusk' \\
  --collect-type followers \\
  --limit 1000 \\
  --include-emails

### Option B: CLI argument

python3 scripts/apify_twitter_actors.py run-pipeline \\
  --apify-token 'apify_api_xxx' \\
  --target 'https://x.com/elonmusk' \\
  --collect-type followers \\
  --limit 1000 \\
  --include-emails

If both are provided, --apify-token is used. If neither is provided, the script returns an explicit authentication error.

### Script Usage

Run with Python 3.10+.

python3 scripts/apify_twitter_actors.py parse-username --target 'https://x.com/elonmusk'

APIFY_TOKEN='apify_api_xxx' \\
python3 scripts/apify_twitter_actors.py run-followers \\
  --target 'https://x.com/elonmusk' \\
  --collect-type followers \\
  --limit 1000

APIFY_TOKEN='apify_api_xxx' \\
python3 scripts/apify_twitter_actors.py run-pipeline \\
  --target 'https://x.com/elonmusk' \\
  --collect-type followers \\
  --limit 1000 \\
  --include-emails

Quick auth check:

APIFY_TOKEN='apify_api_xxx' \\
python3 scripts/apify_twitter_actors.py run-followers \\
  --target 'https://x.com/elonmusk' \\
  --collect-type followers \\
  --limit 10

For contracts and payload details, read:

references/actor-contracts.md
references/troubleshooting.md

### Output Contract

The pipeline returns JSON with:

targetUsername
collectType
totalCollected
emailsFound
rows[] with username, name, email, sourceType, collectedAt

Use this output directly in n8n Code/HTTP nodes or export to CSV/Google Sheets.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: hundevmode
- Version: 1.0.3
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/twitter-x-apify-actors)
- [Send to Agent page](https://openagent3.xyz/skills/twitter-x-apify-actors/agent)
- [JSON manifest](https://openagent3.xyz/skills/twitter-x-apify-actors/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/twitter-x-apify-actors/agent.md)
- [Download page](https://openagent3.xyz/downloads/twitter-x-apify-actors)