SERPsKit Amazon Autopilot Lab

Overview

What you need

• WordPress 6.0+ running PHP 7.2 or higher
• A license key from SERPsKit (format: SKA-XXXXX-XXXXX-XXXXX-XXXXX)
• Amazon Associates account + PA-API credentials
• An OpenAI or Anthropic Claude API key (required for AI features)

1. Installation

2. License activation

License tiers

Moving a license between sites

On the old site: Autopilot Lab → License → Deactivate on this site. Then activate on the new one.

3. Amazon PA-API setup

PA-API is how the plugin fetches live product data. Without it, only the scraper fallback works (risky).

Getting PA-API credentials

1. Log into Amazon Associates
2. Tools → Product Advertising API
3. Manage Your Credentials → Add Credentials
4. Copy Access Key and Secret Key (secret is shown once)

Entering credentials

Supported Amazon locales

US, UK, CA, DE, FR, IT, ES, JP, IN, AU, BR, MX, AE.

Scraper fallback

4. AI provider setup

Configure both OpenAI and Claude so one falls back to the other automatically.

Choosing a provider

Getting API keys

• OpenAI: platform.openai.com/api-keys
• Claude: console.anthropic.com

Both require billing credit before keys work ($5 minimum each).

Configuring

5. General & display settings

General tab

Display tab

Dashboard

Autopilot Lab → Dashboard shows plugin health at a glance:

• License status pill (top-right)
• 4 stat cards — products cached, 7-day clicks, 30-day clicks, AI posts published
• Top clicked products (30d)
• Autopilot status — running or disabled, plus queue stats
• Quick actions — shortcuts to Products, Autopilot, Article Profiles, Settings

Product library

Autopilot Lab → Products holds all cached Amazon products. Products are added three ways:

1. Manually via "Add Product" form
2. Automatically when inserted into a block
3. In bulk by Autopilot when searching for keywords

Adding a product manually

Actions

• ⟳ Refresh — re-fetches live data
• ✕ Delete — removes from cache (re-fetches on next view)

Gutenberg blocks

All 5 blocks live in the Amazon Affiliate category. Open any post, click +, search "amazon".

🛒 Product Box Single product

Single product card for inline mentions.

How to use

1. Insert the Amazon Product Box block
2. Enter ASIN in the placeholder or sidebar
3. Block auto-fetches and previews

Key settings

Setting	Description
Layout	Horizontal or Vertical (card)
Style	Modern, Minimal, Bold, Glass
CTA text	Button label, e.g. "Check on Amazon"
Badge	Ribbon text like "Editor's Choice"
Toggles	Show/hide rating, price, features, Prime

📊 Comparison Table Multi-product · Sortable

The highest-converting block — compare 2–10 products side by side.

How to use

1. Insert the block
2. Add ASINs one by one (press Enter or click + Add)
3. Remove any ASIN by clicking × next to its pill

Key settings

Setting	Description
Table title	Optional heading above the table
CTA text	Button in the action column
Show rank column	Adds #1, #2, #3 badges
Sortable columns	Users can click Rating/Price to sort
Highlight row	Row number for "Editor's Pick" marker

Pro tip: Set Highlight to 1 to mark the first product as Editor's Pick — the best converting position.

📋 Product List Ranked roundup

Vertical ranked list for "Top 10" articles.

How to use

1. Insert the block
2. Add ASINs in order (first = #1)
3. Use ↑ / ↓ to reorder

Key settings

• List title — optional heading
• Rank style: Numbered badge or Medal (🥇🥈🥉)
• CTA text

⚖️ Pros & Cons AI-filled · Multi-line

Two-column pros/cons grid. Fill manually or auto-generate from an ASIN.

Manual use

1. Insert the block
2. Type one pro per line — press Enter for new items
3. Do the same in the Cons column

AI-powered use

1. In the sidebar, enter an ASIN under Auto-fill with AI
2. Click the purple ✨ Generate with AI button
3. Wait 5–10 seconds — textareas fill automatically
4. Edit as needed

Cached: Once generated, pros/cons are cached per ASIN — reusing doesn't burn new AI tokens.

🔥 Deal Box Countdown · High urgency

Red-bannered deal card with optional live countdown.

How to use

1. Insert the block
2. Enter ASIN, deal title, CTA text
3. For countdown: set expiry like 2026-12-31 23:59

Don't fake scarcity: Only use countdowns for real deals.

Shortcodes (Classic Editor)

Single product

[sak_product asin="B08N5WRWNW" layout="horizontal" cta="Buy on Amazon" badge="Editor's Choice"]

Comparison table

[sak_comparison asins="B08N5WRWNW,B09XYZ1234,B07ABC5678"
                title="Best Headphones 2026"
                highlight="1"]

Product list

[sak_list asins="B08N5WRWNW,B09XYZ1234,B07ABC5678" title="Top 3 Picks"]

Deal box

[sak_deal asin="B08N5WRWNW" title="Black Friday Deal" expires="2026-11-29 23:59"]

Pros & cons

[sak_pros_cons asin="B08N5WRWNW"
               pros="Great sound|Long battery|Comfortable"
               cons="Pricey|Heavy"]

Pros and cons use pipe (|) as separator.

AI Article Generation — Two Workflows

The plugin offers two independent workflows for AI article generation. Use whichever fits the task:

🤖 Autopilot — Fast Bulk Generation

Drops keywords into a queue. Cron picks them up and writes articles automatically.

Adding keywords to the queue

best wireless earbuds under 100
how to clean leather boots
top air fryers for small kitchens

Queue statuses

Click ▶ Run next to any pending keyword to generate immediately.

The 7-step pipeline

1. Amazon search — PA-API finds up to 8 matching products
2. Product caching — each saved to your library
3. AI article generation — Claude/OpenAI writes title, intro, sections, FAQ, conclusion
4. Pros/cons generation — each product gets AI pros/cons (commercial only)
5. Block assembly — post is built with all blocks embedded
6. Featured image — downloaded from first product
7. Publication — saved as draft or published

Typical time: 20–90 seconds per article (longer with thinking enabled).

Quality tips

Better keywords

Review checklist before publishing

• Does the intro hook the reader?
• Are pros/cons realistic or generic?
• Do descriptions mention specific features?
• Are prices still accurate?
• Replace blurry featured images
• Add your own personal experience paragraph — biggest ranking lift
• Fix AI clichés ("In the world of...", "When it comes to...")

✨ Article Profiles — Premium Quality

When to use Profiles vs Autopilot

• Use Autopilot when: speed matters, many keywords, general-purpose articles
• Use Profiles when: quality matters, consistent voice/brand, reference material needed (sitemap for internal linking, style guide, brand kit)

Create your first profile

Persistent Instructions

The most important field. These instructions are sent with every article generation request for this profile — exactly like the Instructions box in a Claude.ai Project.

What to put here

• Voice and persona: "You are an experienced [topic] expert writing for yourdomain.com..."
• Style rules: first-person vs third-person, tone, sentence length
• Brand details: name, URL, tagline, anything to reference
• Formatting rules: heading style, paragraph length, list formatting
• Internal linking guidance: "Always check sitemap.txt in this profile and link to relevant existing articles where natural"
• Words/phrases to avoid: AI clichés, over-used terms
• SEO rules: keyword density, meta description format

Reference Files

Upload files that support article writing. Each file's text is extracted and sent as context with every article.

Supported file types

Typical files for a content site

1. sitemap.txt — list of all existing article URLs (for internal linking)
2. style_guide.docx — voice, tone, formatting rules
3. brand_kit.txt — brand name, tagline, key phrases
4. semantic_content_writing_strategy.docx — SEO strategy

Upload a file

Remove a file

Click the red ✕ button next to any file in the list.

Limits

• 5 MB per file
• ~200K total tokens per profile (safety cap)

Generate an article with a profile

Cost & caching

The profile page shows live cost estimates based on your attached files:

• Total tokens — sum of all file tokens
• First article cost — full input cost (Opus 4.7: $5/M tokens)
• Cached article cost — 10% of full price after prompt cache hit

How prompt caching works

With Prompt Caching enabled, the first article you generate in a 5-minute window pays full price for the file context. Subsequent articles within that window pay 10% for the same context. Big savings when generating multiple articles back-to-back.

Example costs (Opus 4.7)

Add output tokens (roughly 4,000 tokens per article = $0.10) to get total cost.

Click tracking

Every affiliate link is wrapped with a tracking redirect: yoursite.com/?sak_go=ASIN&sak_loc=US&sak_pid=123

When clicked, plugin logs ASIN, post ID, device, referrer, hashed IP → redirects to Amazon with your tag.

Viewing stats

• Dashboard — total clicks (7d / 30d), top 5 products
• Top clicked products table — click count per ASIN

SEO & Schema.org markup

JSON-LD structured data is injected automatically for any post with Amazon blocks. Google uses this for rich snippets (stars, prices, images).

• Single product: full Product schema with AggregateRating, Offer, Brand
• Multiple products: ItemList wrapping all products

Testing markup

Use the Google Rich Results Test — should show "Product snippet detected".

Cron & automatic updates

Real cron (for low-traffic sites)

WP-Cron only runs when someone visits. Add a real cron job:

*/5 * * * * wget -q -O - https://yoursite.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1

Then in wp-config.php:

define('DISABLE_WP_CRON', true);

REST API endpoints

For developers — all under /wp-json/sak/v1/, require WP nonce + role.

Troubleshooting

License won't activate

• Verify key typed exactly (no spaces)
• Check server clock is correct (HMAC is time-aware)
• Confirm activation limit not reached

"No products found" for every ASIN

• Re-check PA-API credentials
• Confirm Partner Tag is approved for PA-API
• Need 3+ qualifying sales in 180 days
• Try known ASIN B08N5WRWNW

AI generation fails

• Test API key on provider's console
• Check billing has credit loaded
• Try fallback provider
• For JSON errors: switch to claude-opus-4-7 or gpt-4o

Article Profile upload fails

• Check file is under 5 MB
• Confirm file extension is in allowed list
• For PDF errors: try .txt or .docx version
• DOCX: requires PHP ZipArchive extension (standard on most hosts)

Profile generation very slow

With Adaptive Thinking enabled, Opus 4.7 can take 60-120 seconds. Disable thinking for faster (but lower quality) output, or use a cheaper model in Model Override.

Gutenberg blocks don't appear

• Clear browser cache (Ctrl+Shift+R)
• Disable other plugins to find conflicts
• Check browser console for JS errors

Autopilot generates empty posts

• Keyword too narrow — broaden it
• AI returned invalid JSON — try claude-opus-4-7 or gpt-4o

FAQ

What's the difference between Autopilot and Article Profiles?

Autopilot is for fast bulk generation (queue many keywords, cron writes them). Article Profiles is for premium quality — you create a profile with persistent instructions and reference files, then generate articles one at a time with maximum context. See the comparison table.

Can I use this without PA-API?

Yes via scraper fallback, but violates Amazon TOS and isn't recommended.

Will AI-generated content rank on Google?

Yes IF you review and add human value. Google's Helpful Content guideline isn't "no AI" — it's "helpful and original". Always add personal experience before publishing.

How much do Article Profiles cost vs regular Autopilot?

Profiles with Opus 4.7 + reference files cost more per article (~$0.10-0.30) vs Autopilot with cheaper models (~$0.01-0.05). Worth it for flagship articles where quality matters most.

Can I import my Claude.ai Project?

Not directly — Anthropic's API doesn't expose Projects. But you can copy the Instructions text and re-upload the same files into an Article Profile. The functionality is equivalent.

Does Prompt Caching really save 90%?

Yes, for cached tokens. First article in a 5-minute window pays full price for file context; subsequent articles pay 10%. Output tokens (the article itself) aren't cached.

Can I use Claude Opus 5 or newer when released?

Yes. Use the "Custom model ID" field in Settings to paste any Anthropic model ID without waiting for a plugin update.

Can I move my license between sites?

Yes. Deactivate on old site first, then activate on new.

What happens if my license expires?

Plugin continues working but license status turns "invalid" and REST endpoints stop. Existing posts still render.

How do I customize block designs?

All CSS uses variables. Add to theme's Additional CSS:

:root {
  --sak-primary: #e91e63;
  --sak-primary-dark: #c2185b;
}

Will Amazon ban my account?

Not if you use PA-API (not scraping), refresh prices within 24 hours (automatic), disclose affiliate relationships (plugin does this), and don't make false claims.

How do I backup my data?

Standard WordPress backups cover everything. All plugin data is in tables prefixed wp_sak_.