Pdscrapper Documentation

Getting Started

Quick Start Guide

Pdscrapper is a WordPress plugin that lets you import product data from Amazon product pages and create WooCommerce products in a few clicks.

  1. Install and activate WooCommerce (required).
  2. Install and activate thePdscrapper plugin.
  3. Go to Amazon Scraper in your WordPress admin.
  4. Paste an Amazon product URL and click Scrape.
  5. Review the created product in WooCommerce → Products.

What gets imported?

  • Title, Description, Short Description
  • Product Images (gallery + featured)
  • Price and Sale Price (if available)
  • Basic attributes and variations (when detectable)

Getting Started

Installation

Method 1: WordPress Admin Upload

  1. Go to Plugins → Add New in your WordPress admin
  2. Click Upload Plugin and choose the plugin zip
  3. Click Install Now, then Activate

Method 2: FTP Upload

  1. Extract the plugin zip
  2. Upload the folder to /wp-content/plugins/
  3. Go to Plugins and activate Amazon Scrapper

Important

WooCommerce must be installed and active to create products.

Getting Started

Requirements

Server

  • • WordPress 5.0+
  • • PHP 7.4+
  • • MySQL 5.6+ or MariaDB equivalent
  • • Memory limit 128MB+

Dependencies

  • • WooCommerce 3.0+ (required)
  • • OpenSSL, cURL enabled

Features

Single Product Scrape

Import a single Amazon product by URL.

  1. Open Amazon Scraper in WordPress admin
  2. Paste the Amazon product URL (one URL)
  3. Click Scrape
  4. Wait for the success message and product link

Valid URL examples

  • https://www.amazon.com/dp/XXXXXXXXXX
  • https://www.amazon.com/gp/product/XXXXXXXXXX

Features

Bulk Scrape

Import multiple Amazon products at once using one URL per line.

  1. Open Amazon Scraper → Bulk tab
  2. Paste multiple product URLs (each on a new line)
  3. Click Start Bulk Scrape
  4. Watch live progress and status per URL

Progress & Statistics

  • Total processed, success, failed
  • Elapsed time
  • Recent results table

Error Handling

  • Invalid URL detection
  • Not found / parsing failed
  • Rate limiting backoff

Features

WooCommerce Integration

Scraped products are created as WooCommerce products. Typical fields:

  • Title, short and long description
  • Regular/Sale price (when found)
  • Featured image and gallery
  • Attributes and variations (when detectable)
  • Draft/Publish status depending on your workflow

If WooCommerce is not active, the plugin will display an admin notice and disable scraping actions.

Features

Internationalization (i18n)

The plugin is fully localized with the text domain amazon-scrapper. Both PHP and JavaScript strings can be translated.

  • PHP: wrapped with __(), esc_html__(), etc.
  • JS: uses @wordpress/i18n functions and wp_set_script_translations
  • Translations loaded from /languages directory

Translating

  1. Generate a POT file from the plugin source
  2. Create PO/MO for your locale (e.g., fa_IR)
  3. Place files in languages/ and ensure locale is active

Configuration

Admin UI

Navigate to Amazon Scraper in the WordPress admin to access:

  • Single URL input and Scrape button
  • Bulk textarea (one URL per line) and Start button
  • Recent results table with links to edit/view products
  • Statistics cards (totals, created today, variable products, etc.)

Configuration

Settings

Typical options you can adjust (if available in your build):

  • Default product status (draft or publish)
  • Image handling (download originals, set featured image)
  • Price parsing preferences
  • Category assignment / default category

Configuration

Permissions

Only users with appropriate capabilities can access scraping actions.

  • Admin page visibility controlled via WordPress capabilities
  • AJAX endpoints require valid nonce and capability checks

Technical

AJAX API

The admin UI communicates with the server via AJAX endpoints.

scrape_product

Scrapes a single product.

action: scrape_product
method: POST
params: { url: "https://www.amazon.com/dp/…", _wpnonce: "…" }
response: { success: true, data: { product_id, edit_link, view_link } }

bulk_scrape_products

Scrapes multiple products sequentially.

action: bulk_scrape_products
method: POST
params: { urls: ["…", "…"], _wpnonce: "…" }
response: { success: true, data: { processed, succeeded, failed, results: [...] } }

get_scrapper_stats

Returns dashboard statistics.

action: get_scrapper_stats
method: GET
response: { success: true, data: { total, today, variable, products } }

Technical

Hooks & Filters

Key action/filter points you can rely on may include:

  • Admin page enqueue hooks for scripts and styles
  • AJAX actions for single and bulk scraping
  • Filters to adjust parsed content before product creation

Note: The exact hook names depend on your specific build/version.

Technical

Troubleshooting

Invalid or unsupported URL

Ensure the URL is a valid Amazon product page (e.g., /dp/ or /gp/product/).

WooCommerce is not active

Install and activate WooCommerce; the plugin requires it to create products.

Images not importing

Verify your server can make outbound HTTP requests and allow remote downloads.

Rate limiting or captcha

Try again later or reduce bulk speed; avoid sending too many requests at once.

Technical

Changelog

  • 1.0.0 – Initial release with single and bulk scraping, WooCommerce product creation, i18n support, admin dashboard stats.

Technical

License

Released under GPL-2.0 or later. You are free to modify and redistribute under the same license.