> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skills

> Teach AI coding agents when and how to use Decodo for web scraping, search, and price monitoring.

> [!NOTE]
>
> View the [Agent Skills GitHub repository](https://github.com/Decodo/agent-skills) for the latest skills, installation instructions, and examples.

Agent skills that teach AI coding agents (such as Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Claude Desktop, and claude.ai) **when** to reach for Decodo for web scraping, **which** Decodo tool to use, and **how** to call it.

Decodo handles JavaScript rendering, anti-bot and CAPTCHA handling, proxy rotation, and geo-targeting (125M+ IPs across 195+ locations) so agents get clean web data without managing scraping infrastructure themselves.

## What are agent skills?

Agent skills are instruction files that extend what a coding agent knows how to do. Each skill has a structured description that the agent loads on demand and follows to set up tools, choose the right approach, and handle edge cases without additional prompting.

Without a skill, an agent may default to `curl`, Requests, or Playwright – approaches that can struggle with JavaScript-rendered pages or anti-bot systems and may require you to manage proxies yourself. Decodo skills change that default: the agent detects when a plain fetch isn't suitable and routes the request through the appropriate Decodo tool automatically.

## Skills

| **Skill** | **What it does** |
| - | - |
| `decodo-web-scraping` | Core routing layer for web scraping, web search, mapping and crawling a site, screenshots, Amazon, Walmart, and Target eCommerce data, and TikTok and YouTube social data. Routes across the Decodo CLI, hosted MCP server, and raw HTTP API depending on the agent's environment. |
| `decodo-price-monitoring` | Pricing workflow for getting current prices, finding the cheapest seller across retailers, and tracking prices over time. Supports Amazon, Walmart, Target, and Google Shopping. Builds on `decodo-web-scraping`. |

More workflow skills (e.g. competitive intelligence) are planned.

## Install

### As a plugin (recommended for Claude Code)

Add the repository as a plugin marketplace and install the Decodo plugin. It bundles all available skills in one step:

```text theme={null}
/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills
```

(`decodo-skills` is the marketplace name, while `decodo` is the plugin.)

### Manual copy

These are [Anthropic-format agent skills](https://code.claude.com/docs/en/skills). Copy a skill into your agent's skills directory:

```bash theme={null}
# Claude Code (user-level)
mkdir -p ~/.claude/skills
cp -r skills/decodo-web-scraping ~/.claude/skills/
```

The agent loads skills on demand – no additional configuration needed.

## What the skill expects

* A Web Data API key from the [**Web Data API playground**](https://dashboard.decodo.com/web-data/playground). A free account includes up to 10K free requests, no credit card required.
* A shell for using the CLI. If no shell is available, the skill automatically routes to the hosted MCP server (`https://mcp.decodo.com/mcp`) or the raw HTTP API.

The CLI and the skill's raw API recipes read the key from the `DECODO_AUTH_TOKEN` environment variable:

```bash theme={null}
export DECODO_AUTH_TOKEN='<api-key>'
```

To save it to the CLI config instead, run `decodo setup --token '<api-key>'`.

> [!NOTE]
>
> Older plans only have a basic authentication token. It works for scraping, screenshots, and targets, but web search, mapping, and crawling need an API key.

## Example prompts

Once you've installed a skill, try these prompts with your agent:

```text theme={null}
Scrape the top 5 Hacker News headlines and summarize them.
```

```text theme={null}
Search Google for "best residential proxy providers" and give me the top organic results.
```

```text theme={null}
What is the current price of Amazon product B09H74FXNW? Find the cheapest seller.
```

```text theme={null}
Get the metadata and subtitles for this YouTube video: youtube.com/watch?v=dQw4w9WgXcQ
```

```text theme={null}
Map quotes.toscrape.com and list every author page.
```

```text theme={null}
Track the price of B09H74FXNW on Amazon daily and alert me when it drops below $50.
```

## Repo layout

```text theme={null}
skills/<skill-name>/SKILL.md       # one skill per directory; dir name must match frontmatter `name`
skills/<skill-name>/references/    # optional deep-dive docs the SKILL.md links to (progressive disclosure)
```

***

## Related

* **[CLI](https://help.decodo.com/docs/cli.md)** – Run Decodo scraping workflows from the command line.
* **[MCP Server](https://help.decodo.com/docs/mcp.md)** – Connect AI agents and MCP-compatible tools to Decodo.
* **[TypeScript SDK](https://help.decodo.com/docs/typescript-sdk.md)** – Integrate the Web Scraping API into TypeScript and JavaScript projects.
* **[Python SDK](https://help.decodo.com/docs/python-sdk.md)** – Integrate the Web Scraping API into Python projects.
* **[Go SDK](https://help.decodo.com/docs/go-sdk.md)** – Integrate the Web Scraping API into Go projects.
* [GitHub repository](https://github.com/Decodo/agent-skills) – View the Agent Skills latest skills, installation instructions, and examples.

***

> [card] [Support](https://direct.lc.chat/12092754)
>
> Need help or just want to say hello? Our support is available 24/7. \
> You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).

> [card] [Feedback](mailto:feedback@decodo.com)
>
> Can't find what you're looking for? Request an article! \
> Have feedback? Share your thoughts on how we can improve.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.