KDP X-Ray Helper

About

Tired of clicking through KDP X-Ray entities one by one? This extension automates the entire Kindle X-Ray editing workflow — use any AI to generate character descriptions, then batch-apply changes to your KDP X-Ray verification page in minutes.

🔑 WHAT IT DOES

KDP X-Ray Helper reads all your existing X-Ray entities from the Kindle Direct Publishing verification page, generates an AI-ready prompt, and lets you batch-update everything after reviewing a visual diff. No more spending 3-5 hours manually editing entities for a single book.

⚡ KEY FEATURES

• Batch Entity Editing — Update all X-Ray entities at once instead of clicking each one individually
• AI-Powered Descriptions — Works with any AI: Claude, ChatGPT, Gemini, Copilot, or local models (Ollama, LM Studio)
• Visual Diff Review — See exactly what will change before writing to KDP. Approve or reject each entity individually
• Smart Alias Management — Preserves existing aliases and occurrence counts, adds new ones from AI
• Fuzzy Name Matching — Handles typos, nicknames, and name variations with 5-tier matching engine
• Export & Backup — Save your current KDP entity data as JSON before making changes
• 100% Local — No server, no API keys, no accounts. Everything runs in your browser
• Chrome & Edge — Works on any Chromium browser with Side Panel support (v116+)

📋 HOW IT WORKS

1. Open your KDP X-Ray verification page and click the extension icon
2. Click "Generate Prompt" — the extension reads all your entities automatically
3. Copy the prompt into any AI chat along with your novel text
4. Upload the AI's JSON response back into the extension
5. Review the visual diff, approve changes, click "Execute" — done!

⏱️ TIME SAVINGS

For 100 entities: manual editing takes 3-5 hours → with this extension, ~15-20 minutes (10x faster).
For 200+ entities: the savings are even more dramatic.

🔒 PRIVACY & SECURITY

• The extension NEVER sends your data anywhere — all processing happens locally in your browser
• No analytics, no telemetry, no tracking
• Your novel text only leaves your computer when YOU paste it into your chosen AI
• Works with privacy-focused options: local models (Ollama), Claude (no training by default), or partial text excerpts

📖 PERFECT FOR

• Self-published authors on Amazon KDP
• Indie authors managing multiple books
• Publishers handling X-Ray for their catalog
• Authors who update manuscripts and need to re-do X-Ray descriptions
• Anyone who finds the KDP X-Ray verification page tedious and time-consuming

🤖 WORKS WITH ANY AI

This extension doesn't lock you into a specific AI service. It generates a plain-text prompt that works with:
• Claude (claude.ai) — Recommended for quality
• ChatGPT (chat.openai.com)
• Google Gemini
• Microsoft Copilot
• Local/self-hosted models (Ollama, LM Studio, etc.) — for maximum privacy
• Any AI that can output JSON

💡 WHY X-RAY MATTERS

Kindle X-Ray lets readers tap on any character name or term to see a description. Well-written X-Ray entries make your book feel professional, help readers keep track of complex casts, and improve the overall reading experience. Amazon recommends all authors fill in X-Ray content — but their tool makes it painfully slow. This extension fixes that.

📬 SUPPORT & FEEDBACK

Found a bug or have a feature request? Visit our GitHub repository to file an issue. We actively maintain this extension and welcome contributions from the self-publishing community.