AI Article Importer & Rewriter is a fully automated content pipeline for WordPress. It fetches articles from any RSS, Atom, JSON, or WordPress REST feed, rewrites both content and titles using AI, optimizes SEO metadata, downloads and hosts all images locally, and publishes as WordPress posts — completely hands-free on a schedule you control.

Choose from six AI providers including Google Gemini and Groq (both free, no credit card needed), OpenAI GPT-4o, Anthropic Claude, Mistral, and xAI Grok. Every imported post gets AI-rewritten content, a rephrased title, an SEO-friendly slug, meta descriptions, focus keywords, and Open Graph tags written directly to your SEO plugin — with native support for Yoast, Rank Math, All in One SEO, and SEOPress. Images are downloaded to your media library with responsive srcset, lazy loading, and AI-generated alt text.

Beyond core importing, the plugin offers AI-powered auto-categorization, FAQ block generation with schema markup, content quality scoring, duplicate detection, sensitive content filtering, internal link injection, and a per-feed topic relevance filter. It also includes a social media caption generator for X, Facebook, LinkedIn, and Instagram, an AI-crafted newsletter digest builder, and a roundup/listicle post builder — all managed from a real-time dashboard with full activity logging and system health monitoring.

Feed Importing

• RSS, Atom, JSON Feed, and WordPress REST API support
• Per-feed configuration: name, URL, type, category, author, post status, interval, max posts
• Built-in feed testing with preview before saving
• Atomic duplicate detection via MD5 hash fingerprinting and URL matching
• Per-feed topic relevance filter — AI skips off-topic articles automatically
• Full content scraping when feeds only provide excerpts
• Auto-detect excerpts based on configurable minimum content length
• Configurable CSS selectors for stripping unwanted elements (ads, sidebars, comments, navigation)
• Custom User-Agent header for feed and scraping requests
• Configurable request timeout
• External link stripping option

AI Rewriting

• Content rewriting — full article rephrased in different words while preserving facts
• Title rewriting — rephrased with quality gates for length, format, and commentary detection
• Six AI providers: Google Gemini, OpenAI, Anthropic Claude, Groq, Mistral, xAI Grok
• Multiple models per provider (3–4 options each)
• Adjustable AI temperature (0–1.5)
• Configurable retry attempts on failed API calls
• Fully customizable content rewrite prompt with {content} placeholder
• Fully customizable title rewrite prompt with {title} and {summary} placeholders
• Quality gate: rejects AI output that is suspiciously shorter than the original

SEO Automation

• AI-generated meta descriptions (150–160 characters)
• AI-generated focus keywords (2–4 word keyphrases)
• AI-generated SEO-friendly URL slugs
• Open Graph title, description, and image tags
• Twitter Card meta tags
• Article schema markup
• Native integration with Yoast SEO
• Native integration with Rank Math
• Native integration with All in One SEO
• Native integration with SEOPress
• Support for Squirrly SEO and The SEO Framework
• Basic meta tag fallback when no SEO plugin is installed

Image Pipeline

• Downloads all inline content images to WordPress media library
• Upgrades thumbnail URLs to high-resolution versions
• Generates responsive srcset attributes
• Adds lazy loading attribute to all images
• AI-generated alt text for each image
• Automatic featured image from og:image, feed thumbnail, or first content image
• Posts without any usable image are skipped
• Orphaned source images appended to post content

Video Handling

• YouTube embed preservation and re-injection after AI rewriting
• Vimeo embed preservation
• Native HTML5 video element preservation
• Twitter/X status embed detection
• Video post format set when no featured image is available
• Video URL saved as post meta for theme compatibility

AI Content Enrichment

• Auto-categorize — AI assigns the best matching existing WordPress category
• Auto-tag — AI generates 3–6 relevant tags per post
• AI excerpt generation — 2–3 sentence summary as the WordPress post excerpt
• FAQ block generation — 4 Q&A pairs with FAQPage schema markup for rich snippets
• Internal link injection — Related Articles section linking to relevant published posts
• Configurable max internal links per post

Content Quality & Safety

• Content quality scoring — rates each article 0–100
• Configurable minimum quality score threshold
• Duplicate detection — compares against last 40 posts over 45 days
• Sensitive content filter — detects violence, adult content, politics, misinformation
• Flagged posts saved as drafts with meta flag for manual review
• Minimum title word count enforcement (5 words)

Social Media Post Generator

• Auto-generate captions on import (toggle)
• Manual generate and regenerate per post
• Platform support: X/Twitter, Facebook, LinkedIn, Instagram
• Configurable platform list
• Six tone presets: Professional, Casual, Witty, Enthusiastic, Informative, Provocative
• Include/exclude hashtags toggle
• Custom social prompt for brand-specific instructions
• One-click copy to clipboard per platform
• Captions saved as post meta

Newsletter Digest Builder

• Select posts from recent published articles
• Optional topic hint for focused AI intro
• AI-generated email subject line
• AI-generated intro paragraph
• Per-article one-sentence hooks
• Call-to-action block with customizable URL
• Responsive HTML email template with inline CSS
• Plain text fallback version
• Copy HTML, Copy Plain Text, and Download HTML export options
• Configurable posts per digest count
• Brand name override for newsletter header
• Custom CTA link URL

Roundup / Listicle Builder

• Enter a central topic theme
• Select 3–20 source articles from published posts
• AI-generated SEO-optimized roundup title
• AI-generated 2-paragraph intro
• Per-item original commentary (not just summaries)
• Source links back to original posts
• AI-generated conclusion paragraph
• Save directly as WordPress post with chosen status, category, and author
• Preview before publishing
• Configurable default topic, default post status, and max articles per roundup

Admin Dashboard

• Active feeds count with green highlight
• Total posts created (cumulative)
• Posts created today
• Errors in last 24 hours with red highlight
• System status panel: AI provider, API key status, next fetch time, WP-Cron health, SEO plugin detection, post status
• Recent activity feed (last 12 log entries)
• Environment & debug panel: PHP version, memory limit, max execution time, DOM extension, cURL extension, WP version, plugin version, stuck rows count, cron lock status

Activity Logs

• Info, Warning, and Error log levels
• AJAX-powered live filtering by level
• Per-feed log entries with feed ID
• Clear all logs button
• Configurable max log entries with auto-pruning
• Timestamped entries with human-readable formatting

Cron & Scheduling

• WP-Cron integration with custom interval
• Global cron interval: 30 min, 1 hour, 2 hours, 4 hours, daily
• Per-feed fetch interval override
• Automatic cron rescheduling when interval setting changes
• Manual Fetch Now button per feed
• Background processing via loopback request
• Fallback WP-Cron single event scheduling
• Per-feed concurrency lock to prevent overlapping runs
• Global cron lock with 5-minute safety timeout
• Automatic cleanup of stuck processing rows (daily)
• Automatic cron event self-healing if schedule goes missing

Security

• SSRF protection — blocks localhost, private IPs, and reserved ranges on feed URLs
• Server-side whitelist validation on feed type and post status
• Server-side bounds enforcement on numeric fields
• Post author validation against real site users
• Nonce-protected AJAX handlers
• Capability checks (manage_options) on all admin actions
• Background fetch secured by short-lived nonce (no login cookie required)

Compatibility

• WordPress 5.8+
• PHP 7.4+ (8.0+ recommended)
• PHP cURL and DOM extensions
• 128 MB minimum memory
• WordPress 6.7+ textdomain compatibility
• GPL v2 or later license

Server Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher (PHP 8.0+ recommended)
• PHP cURL extension
• PHP DOM extension
• 128 MB PHP memory limit or higher
• Outbound HTTPS access (server must reach AI provider API endpoints)

Cron

• WP-Cron enabled (default on all WordPress installs)
• Real server cron job recommended for low-traffic sites

AI Provider (at least one)

• Google Gemini — free, no credit card required (aistudio.google.com/apikey)
• Groq — free, no credit card required (console.groq.com/keys)
• OpenAI — paid (platform.openai.com/api-keys)
• Anthropic Claude — paid (console.anthropic.com)
• Mistral AI — paid (console.mistral.ai/api-keys)
• xAI Grok — free tier available (console.x.ai)

Optional but Recommended

• SEO plugin: Yoast SEO, Rank Math, All in One SEO, or SEOPress for full SEO meta integration
• Real server cron job for reliable scheduled fetching on low-traffic sites

Installation

1. Download the plugin ZIP file from CodeCanyon
2. Go to your WordPress admin → Plugins → Add New → Upload Plugin
3. Select the ZIP file and click Install Now
4. Click Activate Plugin
5. A new menu "AI Article Importer & Rewriter" appears in your admin sidebar

Step 1 — Get an AI API Key

You need at least one API key. Google Gemini is recommended because it is completely free.

• Google Gemini (free): Go to aistudio.google.com/apikey, sign in with your Google account, and create a key
• Groq (free): Go to console.groq.com/keys and create a key
• OpenAI (paid): Go to platform.openai.com/api-keys
• Anthropic (paid): Go to console.anthropic.com
• Mistral (paid): Go to console.mistral.ai/api-keys
• xAI (free tier): Go to console.x.ai

Step 2 — Configure Your AI Provider

1. Go to AI Article Importer → Settings
2. Click the AI Provider tab
3. Select your provider by clicking its card (e.g. Google Gemini)
4. Paste your API key in the API Key field
5. Choose your preferred model from the dropdown
6. Click Save Changes at the bottom of the page

Step 3 — Add Your First Feed Source

1. Go to AI Article Importer → Feed Sources
2. Click + Add Feed Source
3. Enter a name (e.g. "BBC Sport")
4. Select the feed type: RSS/Atom, JSON Feed, or WordPress REST API
5. Paste the feed URL (e.g. https://feeds.bbci.co.uk/sport/rss.xml)
6. Choose a category, post author, and post status (start with Draft)
7. Set max posts per fetch (default 5) and fetch interval
8. Configure the feature toggles:
   • AI Rephrase Content & Title — rewrites using your AI provider
   • AI SEO Optimization — generates meta descriptions and keywords
   • Download & Host Images — saves images to your media library
   • Fetch Full Article — scrapes the source page for complete content
9. Optionally set a Topic Profile to filter articles by topic (e.g. "Premier League football, transfer news")
10. Click Test Feed to verify the URL works
11. Click Save Feed

Step 4 — Run Your First Fetch

1. On the Feed Sources page, find your feed card
2. Click the Fetch Now button
3. Wait 15–60 seconds (processing runs in the background)
4. Go to Posts → All Posts to see your new imported drafts
5. Review the AI-rewritten content, SEO metadata, and images
6. If everything looks good, change the post status to Publish or adjust your feed settings to publish automatically

Step 5 — Configure Prompts (Optional)

1. Go to Settings → Prompts tab
2. Edit the Content Rephrase Prompt to control how AI rewrites articles. Use {content} as the placeholder for the original article text
3. Edit the Title Rephrase Prompt to control how titles are rephrased. Use {title} as the placeholder
4. Adjust AI Temperature (lower = more faithful to original, higher = more creative, recommended 0.6–0.8)
5. Set Retry Attempts for failed API calls (default 2)
6. Click Save Changes

Step 6 — Configure Content Fetching (Optional)

1. Go to Settings → Fetching tab
2. Toggle Fetch Full Article Content on if your feeds only provide excerpts
3. Toggle Auto-detect Excerpts to automatically scrape when content looks truncated
4. Toggle Remove External Links to strip outbound hyperlinks from imported content
5. Set Minimum Content Length (articles shorter than this are treated as excerpts)
6. Set Request Timeout for HTTP requests
7. Edit Elements to Strip to remove specific page elements during scraping (e.g. script, style, nav, .sidebar, .comments, .ad)
8. Click Save Changes

Step 7 — Enable AI Features (Optional)

1. Go to Settings → AI Features tab
2. Toggle on any features you want:
   • Auto-Categorize & Tag — AI picks the best category and generates tags
   • AI Excerpt Generation — creates a summary for the post excerpt field
   • FAQ Block Generation — appends a 4-question FAQ with schema markup
   • Internal Link Injection — adds Related Articles linking to your existing posts
   • Content Quality Scoring — rates articles 0–100 and discards low-quality ones
   • Duplicate Detection — skips articles similar to your recent posts
   • Sensitive Content Filter — flags problematic content and saves as draft
3. Set Max Internal Links Per Post and Minimum Quality Score as needed
4. Click Save Changes

Note: Each enabled feature adds one extra AI API call per imported post. On free tiers, enable selectively.

Step 8 — Set Up Social Media Posts (Optional)

1. Go to Settings → Publishing tab
2. Toggle Auto-Generate on Import to create social captions for every imported post
3. Toggle Include Hashtags on or off
4. Set your Platforms (e.g. twitter, facebook, linkedin, instagram)
5. Choose a Tone / Voice (Professional, Casual, Witty, Enthusiastic, Informative, or Provocative)
6. Optionally add a Custom Social Prompt for brand-specific instructions (e.g. "Always mention @YourHandle. Use British English.")
7. Click Save Changes
8. View generated captions at AI Article Importer → Social Posts
9. Click the Copy button next to any caption to copy it to your clipboard

Step 9 — Build a Newsletter Digest (Optional)

1. Go to AI Article Importer → Newsletter
2. Enter a topic or focus (optional — helps AI write a focused intro)
3. Select the number of posts to include
4. Check the posts you want in the digest
5. Click Build Digest ###li/li###
6. Use Copy HTML to paste into Mailchimp, ConvertKit, or any email platform
7. Use Copy Plain Text for simple email clients
8. Use Download HTML to save the file

To set defaults: Go to Settings → Publishing → Newsletter Digest section to configure posts per digest, default topic, brand name override, and CTA URL.

Step 10 — Build a Roundup Post (Optional)

1. Go to AI Article Importer → Roundup
2. Enter a roundup topic (e.g. "Best Premier League Goals This Week")
3. Choose post status, category, and author
4. Select 3–10 articles from the checkbox list
5. Click Generate Roundup Post
6. Preview the generated content on the right panel
7. Click Save as Post to create a WordPress post

To set defaults: Go to Settings → Publishing → Roundup Builder section to configure default topic, post status, and max articles.

Step 11 — Configure System Settings (Optional)

1. Go to Settings → System tab
2. Set Default Post Status for all new imports (Draft, Pending Review, or Publish)
3. Set Global Cron Interval (how often the plugin checks all feeds)
4. Choose your SEO Plugin or leave on Auto-detect
5. Toggle Enable Activity Logging and set Max Log Entries
6. Click Save Changes

Step 12 — Set Up a Real Cron Job (Recommended)

WordPress cron only fires when someone visits your site. For reliable scheduling on low-traffic sites, add a real server cron job.

In cPanel → Cron Jobs, add one of these (replace yoursite.com with your domain):

Every 15 minutes via wget:
*/15 * * * * wget -q -O /dev/null "https://yoursite.com/wp-cron.php?doing_wp_cron"

Every 15 minutes via WP-CLI (most reliable):
*/15 * * * * cd /path/to/wordpress && wp cron event run --due-now --quiet

Monitoring & Troubleshooting

• Dashboard: Go to AI Article Importer → Dashboard to see stats, system status, and recent activity at a glance
• Logs: Go to AI Article Importer → Logs to see detailed activity with Info, Warning, and Error levels. Use the filter tabs to isolate errors. This is your first stop when something is not working
• Debug Panel: The Environment & Debug section on the Dashboard shows PHP version, memory, extensions, stuck rows, and cron lock status

Recommended Workflow for New Users

1. Start with post status set to Draft
2. Add one feed and click Fetch Now
3. Review the imported drafts — check the rewritten content, title, SEO metadata, and featured image
4. Adjust your prompts or settings if needed
5. Once satisfied, switch post status to Publish or Pending Review
6. Add more feeds and enable additional AI features as needed
7. Set up a real cron job for hands-free operation