{
  "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": {
    "downloadMode": "redirect",
    "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",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "agents/openai.yaml",
      "references/actor-contracts.md",
      "references/troubleshooting.md",
      "requirements.txt"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/twitter-x-apify-actors",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "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.\n\nUse this skill when a user asks to:\n\ncollect followers/following from X via Apify actors\nenrich collected usernames with emails\nconvert profile links to actor-ready usernames\nbuild JSON/webhook payloads for n8n or API endpoints\n\nDefault actor IDs in this skill:\n\nFollowers actor: bIYXeMcKISYGnHhBG\nEmail actor: mSaHt2tt3Z7Fcwf0o"
      },
      {
        "title": "Quick Workflow",
        "body": "Parse input target (https://x.com/..., https://twitter.com/..., or @username).\nBuild follower actor payload using collectType and limit.\nRun follower actor and normalize usernames.\nIf enrichment is enabled, run email actor and merge results.\nReturn final rows + summary metrics."
      },
      {
        "title": "Execution Rules",
        "body": "Prefer script execution for reliability: use scripts/apify_twitter_actors.py.\nKeep actor IDs configurable, but default to the IDs above.\nAlways validate collectType (followers, following, both) and positive limit.\nIf email enrichment is disabled, skip email actor entirely.\nNever hardcode the Apify token in outputs. Use env APIFY_TOKEN or explicit CLI argument."
      },
      {
        "title": "Authentication (Apify token)",
        "body": "Users can provide the Apify API token in two supported ways."
      },
      {
        "title": "Option A: Environment variable (recommended)",
        "body": "export APIFY_TOKEN='apify_api_xxx'\npython3 scripts/apify_twitter_actors.py run-pipeline \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000 \\\n  --include-emails"
      },
      {
        "title": "Option B: CLI argument",
        "body": "python3 scripts/apify_twitter_actors.py run-pipeline \\\n  --apify-token 'apify_api_xxx' \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000 \\\n  --include-emails\n\nIf both are provided, --apify-token is used. If neither is provided, the script returns an explicit authentication error."
      },
      {
        "title": "Script Usage",
        "body": "Run with Python 3.10+.\n\npython3 scripts/apify_twitter_actors.py parse-username --target 'https://x.com/elonmusk'\n\nAPIFY_TOKEN='apify_api_xxx' \\\npython3 scripts/apify_twitter_actors.py run-followers \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000\n\nAPIFY_TOKEN='apify_api_xxx' \\\npython3 scripts/apify_twitter_actors.py run-pipeline \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000 \\\n  --include-emails\n\nQuick auth check:\n\nAPIFY_TOKEN='apify_api_xxx' \\\npython3 scripts/apify_twitter_actors.py run-followers \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 10\n\nFor contracts and payload details, read:\n\nreferences/actor-contracts.md\nreferences/troubleshooting.md"
      },
      {
        "title": "Output Contract",
        "body": "The pipeline returns JSON with:\n\ntargetUsername\ncollectType\ntotalCollected\nemailsFound\nrows[] with username, name, email, sourceType, collectedAt\n\nUse this output directly in n8n Code/HTTP nodes or export to CSV/Google Sheets."
      }
    ],
    "body": "Twitter/X Apify Actors\nOverview\n\nThis 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.\n\nUse this skill when a user asks to:\n\ncollect followers/following from X via Apify actors\nenrich collected usernames with emails\nconvert profile links to actor-ready usernames\nbuild JSON/webhook payloads for n8n or API endpoints\n\nDefault actor IDs in this skill:\n\nFollowers actor: bIYXeMcKISYGnHhBG\nEmail actor: mSaHt2tt3Z7Fcwf0o\nQuick Workflow\nParse input target (https://x.com/..., https://twitter.com/..., or @username).\nBuild follower actor payload using collectType and limit.\nRun follower actor and normalize usernames.\nIf enrichment is enabled, run email actor and merge results.\nReturn final rows + summary metrics.\nExecution Rules\nPrefer script execution for reliability: use scripts/apify_twitter_actors.py.\nKeep actor IDs configurable, but default to the IDs above.\nAlways validate collectType (followers, following, both) and positive limit.\nIf email enrichment is disabled, skip email actor entirely.\nNever hardcode the Apify token in outputs. Use env APIFY_TOKEN or explicit CLI argument.\nAuthentication (Apify token)\n\nUsers can provide the Apify API token in two supported ways.\n\nOption A: Environment variable (recommended)\nexport APIFY_TOKEN='apify_api_xxx'\npython3 scripts/apify_twitter_actors.py run-pipeline \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000 \\\n  --include-emails\n\nOption B: CLI argument\npython3 scripts/apify_twitter_actors.py run-pipeline \\\n  --apify-token 'apify_api_xxx' \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000 \\\n  --include-emails\n\n\nIf both are provided, --apify-token is used. If neither is provided, the script returns an explicit authentication error.\n\nScript Usage\n\nRun with Python 3.10+.\n\npython3 scripts/apify_twitter_actors.py parse-username --target 'https://x.com/elonmusk'\n\nAPIFY_TOKEN='apify_api_xxx' \\\npython3 scripts/apify_twitter_actors.py run-followers \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000\n\nAPIFY_TOKEN='apify_api_xxx' \\\npython3 scripts/apify_twitter_actors.py run-pipeline \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 1000 \\\n  --include-emails\n\n\nQuick auth check:\n\nAPIFY_TOKEN='apify_api_xxx' \\\npython3 scripts/apify_twitter_actors.py run-followers \\\n  --target 'https://x.com/elonmusk' \\\n  --collect-type followers \\\n  --limit 10\n\n\nFor contracts and payload details, read:\n\nreferences/actor-contracts.md\nreferences/troubleshooting.md\nOutput Contract\n\nThe pipeline returns JSON with:\n\ntargetUsername\ncollectType\ntotalCollected\nemailsFound\nrows[] with username, name, email, sourceType, collectedAt\n\nUse this output directly in n8n Code/HTTP nodes or export to CSV/Google Sheets."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/hundevmode/twitter-x-apify-actors",
    "publisherUrl": "https://clawhub.ai/hundevmode/twitter-x-apify-actors",
    "owner": "hundevmode",
    "version": "1.0.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}