How do I install the Turnstile skill?

Run npx skillmds@latest add acedatacloud/turnstile in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Turnstile safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Turnstile?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Turnstile free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Turnstile?

acedatacloud (@acedatacloud) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Turnstile by acedatacloud — Agent Skill

Name: Turnstile
Rating: 4.5 (4 reviews)
Author: acedatacloud

Turnstile

Solve Cloudflare Turnstile CAPTCHAs via AceDataCloud API. Use when you need to bypass or solve a Cloudflare Turnstile challenge by providing the site key and page URL to get back a valid token. Supports synchronous and asynchronous modes.

acedatacloud Updated Sep 9, 2026

File contents

Cloudflare Turnstile CAPTCHA Solver

Solve Cloudflare Turnstile CAPTCHA challenges through AceDataCloud's captcha API. Submit the site key and target URL to receive a valid cf-turnstile-response token.

Setup: See authentication for token setup.

Quick Start

curl -X POST https://api.acedata.cloud/captcha/token/turnstile \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{
    "website_key": "0x4AAAAAAADnPIDROrmt1Wwj",
    "website_url": "https://react-turnstile.vercel.app"
  }'

A successful synchronous response:

{
  "token": "0.mNQ2f9uP6mQ0y3H5Q8bqO7iM...",
  "started_at": 1784885653.0,
  "finished_at": 1784885665.0,
  "elapsed": 12.4
}

Use the returned token as the cf-turnstile-response value when submitting forms to the target site. The token is single-use with a ~120s validity — use it within 60s.

How to Find `website_key`

Open the target page in a browser and press F12 to open DevTools
In the Elements panel, search for cf-turnstile
Find the container element — the data-sitekey attribute value is the website_key

Parameters

Parameter	Required	Description
`website_key`	✓	The Turnstile site key (`data-sitekey`) from the target page
`website_url`	✓	The full URL of the page containing the Turnstile widget
`action`		Custom `action` value — only needed when the target page sets a custom action
`cdata`		Custom `cData` value — only needed when the target page sets a custom cData
`async`		When `true`, return immediately with a `task_id`; poll `POST /captcha/tasks` to retrieve the token

Response Fields

Field	Description
`token`	The solved Turnstile token to submit as `cf-turnstile-response`
`started_at`	ISO-8601 timestamp when solving began
`finished_at`	ISO-8601 timestamp when solving completed
`elapsed`	Total solving time in seconds

Async Mode

Pass async: true to return a task_id immediately instead of blocking:

POST /captcha/token/turnstile
{
  "website_key": "0x4AAAAAAADnPIDROrmt1Wwj",
  "website_url": "https://react-turnstile.vercel.app",
  "async": true
}

Then poll POST /captcha/tasks with the returned task_id:

POST /captcha/tasks
{"task_id": "<task_id>"}

Async: See async task polling for the full polling contract.

Using the Token

Submit the token to the target site as cf-turnstile-response:

import requests

token = "0.mNQ2f9uP6mQ0y3H5Q8bqO7iM..."
response = requests.post(
    "https://react-turnstile.vercel.app",
    data={"cf-turnstile-response": token}
)

Gotchas

Both website_key and website_url are required
The token is single-use and valid for ~120s — use within 60s for best results
action and cdata are optional and only required when the target site explicitly uses them
You are billed only when a token is successfully solved
Synchronous mode blocks until the token is ready (typically 10–30s); use async: true for non-blocking operation

MCP: See MCP servers for tool-use integration.

---name: turnstiledescription: Solve Cloudflare Turnstile CAPTCHAs via AceDataCloud API. Use when you need to bypass or solve a Cloudflare Turnstile challenge by providing the site key and page URL to get back a valid token. Supports synchronous and asynchronous modes.license: Apache-2.0--- # Cloudflare Turnstile CAPTCHA Solver Solve Cloudflare Turnstile CAPTCHA challenges through AceDataCloud's captcha API. Submit the site key and target URL to receive a valid `cf-turnstile-response` token. > **Setup:** See [authentication](../_shared/authentication.md) for token setup. ## Quick Start ```bash curl -X POST https://api.acedata.cloud/captcha/token/turnstile \ -H "Authorization: ******" \ -H "Content-Type: application/json" \ -d '{ "website_key": "0x4AAAAAAADnPIDROrmt1Wwj", "website_url": "https://react-turnstile.vercel.app" }' ``` A successful synchronous response: ```json { "token": "0.mNQ2f9uP6mQ0y3H5Q8bqO7iM...", "started_at": 1784885653.0, "finished_at": 1784885665.0, "elapsed": 12.4 } ``` Use the returned `token` as the `cf-turnstile-response` value when submitting forms to the target site. The token is single-use with a ~120s validity — use it within 60s. ## How to Find `website_key` 1. Open the target page in a browser and press F12 to open DevTools 2. In the Elements panel, search for `cf-turnstile` 3. Find the container element — the `data-sitekey` attribute value is the `website_key` ## Parameters | Parameter | Required | Description | |-----------|----------|-------------| | `website_key` | ✓ | The Turnstile site key (`data-sitekey`) from the target page | | `website_url` | ✓ | The full URL of the page containing the Turnstile widget | | `action` | | Custom `action` value — only needed when the target page sets a custom action | | `cdata` | | Custom `cData` value — only needed when the target page sets a custom cData | | `async` | | When `true`, return immediately with a `task_id`; poll `POST /captcha/tasks` to retrieve the token | ## Response Fields | Field | Description | |-------|-------------| | `token` | The solved Turnstile token to submit as `cf-turnstile-response` | | `started_at` | ISO-8601 timestamp when solving began | | `finished_at` | ISO-8601 timestamp when solving completed | | `elapsed` | Total solving time in seconds | ## Async Mode Pass `async: true` to return a `task_id` immediately instead of blocking: ```json POST /captcha/token/turnstile { "website_key": "0x4AAAAAAADnPIDROrmt1Wwj", "website_url": "https://react-turnstile.vercel.app", "async": true } ``` Then poll `POST /captcha/tasks` with the returned `task_id`: ```json POST /captcha/tasks {"task_id": "<task_id>"} ``` > **Async:** See [async task polling](../_shared/async-tasks.md) for the full polling contract. ## Using the Token Submit the token to the target site as `cf-turnstile-response`: ```python import requests token = "0.mNQ2f9uP6mQ0y3H5Q8bqO7iM..." response = requests.post( "https://react-turnstile.vercel.app", data={"cf-turnstile-response": token} ) ``` ## Gotchas - Both `website_key` and `website_url` are **required** - The token is single-use and valid for ~120s — use within 60s for best results - `action` and `cdata` are optional and only required when the target site explicitly uses them - You are billed only when a token is successfully solved - Synchronous mode blocks until the token is ready (typically 10–30s); use `async: true` for non-blocking operation > **MCP:** See [MCP servers](../_shared/mcp-servers.md) for tool-use integration.

Frequently asked questions