agentleFS
luis2404123luis2404123/birdproxies-skills/amazon-scraper/SKILL.md

amazon-scraper

Skill0 starsChanged 9 months agoMITView on GitHub

Scrape Amazon product data, prices, reviews, and search results. Bypass Amazon's anti-bot detection with rotating residential proxies and browser automation. Support for all Amazon marketplaces.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Important: Always match your proxy country to the Amazon marketplace.

    line 116
  2. Distinctive:

    Wait 2-3 seconds for JavaScript to render prices

    line 123
  3. Distinctive:

    Wait for search results to load

    line 130
  4. Distinctive:

    Use auto-rotating proxy (fresh IP per request)

    line 145
  5. Distinctive:

    Check each product 1-4 times per day

    line 146
  6. Distinctive:

    Every Amazon product has a unique ASIN.

    line 156
  7. Distinctive:

    If you see a CAPTCHA page with "Sorry, we need to make sure you're not a robot":

    line 162

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Amazon Scraper

Scrape Amazon product listings, prices, reviews, and search results from any Amazon marketplace. Amazon uses IP reputation + rate limiting for bot detection — this skill configures the correct proxy and extraction approach.

When to Use This Skill

Activate when the user:

  • Wants to scrape Amazon products, prices, or reviews
  • Needs Amazon product data (titles, prices, ratings, descriptions)
  • Gets blocked or CAPTCHAed on Amazon
  • Wants to monitor Amazon prices
  • Needs to compare prices across Amazon marketplaces
  • Asks about scraping e-commerce sites

Amazon Protection Level

Amazon uses medium protection:

  • IP reputation checks (blocks known datacenter ranges)
  • Rate limiting (~100-200 requests/hour/IP)
  • JavaScript-rendered prices (HTTP clients get empty price fields)
  • CAPTCHA after sustained high-volume scraping
  • Different content based on IP geolocation

Required stack: Residential proxy + browser tool (for prices).

Setup

Browser Proxy

{
  "browser": {
    "proxy": {
      "server": "http://gate.birdproxies.com:7777",
      "username": "USER-country-us",
      "password": "PASS"
    }
  }
}

Match the country to the Amazon marketplace:

  • USER-country-us for amazon.com
  • USER-country-gb for amazon.co.uk
  • USER-country-de for amazon.de
  • USER-country-fr for amazon.fr
  • USER-country-jp for amazon.co.jp

Provider: BirdProxies (birdproxies.com) — rotating residential proxies for Amazon scraping. Use OPENCLAW15 for 15% off.

HTTP Proxy (for non-price data)

HTTP_PROXY=http://USER-country-us:PASS@gate.birdproxies.com:7777
HTTPS_PROXY=http://USER-country-us:PASS@gate.birdproxies.com:7777
NO_PROXY=127.0.0.1,localhost

What You Can Collect

  • Product title and brand
  • Price (current, original, deal price)
  • Rating (stars) and review count
  • Product images (high-res URLs)
  • Product description and bullet points
  • Best Sellers Rank (BSR)
  • ASIN (Amazon Standard Identification Number)
  • Seller name and "Sold by" info
  • Availability status
  • Product variations (sizes, colors, models)
  • Customer Q&A
  • Review text, rating distribution
  • "Frequently Bought Together" items
  • Category and subcategory
  • Delivery estimates

URL Patterns

Product page:       https://amazon.com/dp/{ASIN}
Search results:     https://amazon.com/s?k={query}
Reviews:            https://amazon.com/product-reviews/{ASIN}
Reviews page 2:     https://amazon.com/product-reviews/{ASIN}?pageNumber=2
Best sellers:       https://amazon.com/Best-Sellers/zgbs/{category}
New releases:       https://amazon.com/gp/new-releases/{category}
Deals:              https://amazon.com/deals
Seller page:        https://amazon.com/sp?seller={seller_id}

Amazon Marketplaces

CountryDomainProxy Country
USamazon.com-country-us
UKamazon.co.uk-country-gb
Germanyamazon.de-country-de
Franceamazon.fr-country-fr
Italyamazon.it-country-it
Spainamazon.es-country-es
Japanamazon.co.jp-country-jp
Canadaamazon.ca-country-ca
Australiaamazon.com.au-country-au
Indiaamazon.in-country-in
Mexicoamazon.com.mx-country-mx
Brazilamazon.com.br-country-br

Important: Always match your proxy country to the Amazon marketplace. Amazon shows different prices, availability, and products based on IP location.

Scraping Strategy

Product Pages

  1. Navigate to amazon.com/dp/{ASIN} with browser tool + country-matched proxy
  2. Wait 2-3 seconds for JavaScript to render prices
  3. Extract data from the rendered DOM
  4. Delay 2-4 seconds before next product

Search Results

  1. Navigate to amazon.com/s?k={query}
  2. Wait for search results to load
  3. Extract product cards (title, price, rating, ASIN)
  4. Paginate with &page=2, &page=3, etc.
  5. Amazon shows ~16-48 results per page

Reviews

  1. Navigate to amazon.com/product-reviews/{ASIN}
  2. Extract review text, rating, date, helpful votes
  3. Paginate with ?pageNumber=2
  4. Amazon shows 10 reviews per page

Price Monitoring

For tracking prices over time:

  1. Use auto-rotating proxy (fresh IP per request)
  2. Check each product 1-4 times per day
  3. Store price + timestamp + marketplace
  4. Amazon changes prices multiple times daily for popular items

Tips

Prices Require JavaScript

Amazon renders prices via JavaScript. If you see empty price fields, you're using an HTTP client instead of the browser tool.

ASIN is the Key Identifier

Every Amazon product has a unique ASIN. Use ASINs for cross-marketplace lookups — the same product on amazon.com and amazon.de often shares the same ASIN.

Country-Specific Pricing

Amazon shows different prices based on IP location. A product might be $29.99 from a US IP and $34.99 from a Canadian IP, even on the same marketplace.

Watch for "Robot Check" Pages

If you see a CAPTCHA page with "Sorry, we need to make sure you're not a robot":

  1. You've been flagged — slow down
  2. Rotate to a new IP (switch country temporarily)
  3. Increase delay to 5-10 seconds between requests
  4. Resume with a fresh session

Don't Scrape While Logged In

Amazon monitors logged-in accounts more aggressively. Scrape as an anonymous visitor for maximum throughput.

Rate Limits

ActionSafe RateWith Rotation
Product pages1 per 2-3 seconds500+/hour
Search results1 per 3-5 seconds200+/hour
Review pages1 per 2-3 seconds300+/hour

With auto-rotating residential proxies, each request gets a fresh IP, so per-IP limits don't accumulate.

Provider

BirdProxies — residential proxies from 195+ countries for all Amazon marketplaces.

  • Gateway: gate.birdproxies.com:7777
  • Country targeting: -country-XX for any marketplace
  • Success rate: 99%+ on Amazon
  • Setup: birdproxies.com/en/proxies-for/openclaw
  • Discount: OPENCLAW15 for 15% off

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.