Aranx Connector

By aranx

0+ active installationsVersion 1.7.0

Connect your WordPress site to Aranx for AI-powered SEO content that publishes on autopilot.

Description

Aranx turns your WordPress blog into a traffic engine that runs on autopilot. Connect your site, and Aranx handles everything – from finding the right keywords to publishing optimized articles.

This plugin connects your WordPress site to Aranx so articles flow directly into your posts.

What it does

  • Keyword research to publishing in one step – Aranx researches, writes, and publishes. Articles appear as WordPress posts automatically
  • Two-way sync – Post status changes in WordPress are reflected in Aranx
  • SEO meta tags – Outputs the title and meta description when no SEO plugin is active
  • Built-in image creation – Each article includes AI-generated images, uploaded to your media library
  • AI bot visits – Counts the pages that ChatGPT, Claude, and Perplexity bots read, for Aranx AI Visibility
  • Visitors from AI apps – Counts the people who open your site from a link in ChatGPT, Perplexity, Gemini, Claude, or Copilot, for Aranx AI Visibility. Pages that a page cache or a CDN serves count too
  • Connection monitoring – Automatic health checks and reconnection if anything drops
  • Activity logging – See exactly what’s been synced and when

How it works

  1. Install and activate the plugin
  2. Click “Connect to Aranx” and approve the secure connection
  3. Content created in Aranx publishes to your site automatically

External services

This plugin connects your site to Aranx, an SEO content service run by Aranx. An Aranx account is required. Aranx writes articles and publishes them to your site through this plugin.

No data is sent until you connect your site. The plugin makes no external requests before you click “Connect to Aranx” on its settings page.

When you click “Connect to Aranx”, your browser opens app.aranx.com with these details so Aranx can set up your site:

  • Site URL, site name, and the site admin email address
  • WordPress version, plugin version, site language, timezone, and permalink structure

After you approve the connection, the plugin sends these requests to api.aranx.com:

  • Once, to exchange a short-lived, one-time authorization code for paired API keys. The request contains the code, a PKCE verifier, and the site URL.
  • When an Aranx-created post is edited, changes status, or is deleted. The request contains the post ID, title, content, excerpt, status, type, slug, URL, edit URL, created and modified dates, categories, tags, featured image, comment and ping status, menu order, parent ID, and the author’s ID and display name.
  • Every hour, a heartbeat for connection health. It contains the site URL, admin URL, site ID, WordPress, PHP, and plugin versions, and post and page counts.
  • After the plugin imports article images, a report for each import job. It contains the job ID, the result, the new media library IDs and URLs, and any errors.
  • Once a day, a connection check that sends empty HEAD requests to three Aranx API endpoints.
  • Every 5 minutes, the visits of AI search bots and AI answer fetchers (OAI-SearchBot, ChatGPT-User, Claude-SearchBot, Claude-User, PerplexityBot, Perplexity-User) since the last send. Each visit contains the page URL without its query string, the time, the response status code, the user agent, and the IP address of the request. Aranx uses the IP address only to check that the visit came from the AI company’s published IP ranges, and does not store it. Visits of other user agents are not recorded or sent. Visits wait in a database table until they are sent, at most 3 days. The plugin deletes them when you disconnect, deactivate, or turn this off. The aranx_ai_traffic_enabled filter turns this off.
  • Every 5 minutes, with the AI bot visits, the visits of people who opened your site from a link in ChatGPT, Perplexity, Gemini, Claude, or Copilot. While the site is connected, a small script on your public pages checks the referrer and the utm_source parameter in the visitor’s browser. Only when they name one of these apps does it send the page path, the referrer’s domain, the utm_source value, and whether the page was found to your site’s own REST API (/wp-json/aranx/v1/ai-visit). The plugin stores these with the time and sends them to Aranx. It stores no IP address, user agent, cookie, or other query parameter for these visits. To limit abuse, it keeps a salted hash of the IP address for 10 minutes. Other visits send nothing. The aranx_ai_traffic_enabled filter turns this off too.
  • When you open the AI visits or Articles page of the Aranx admin, a request for the site’s AI visit counts over the last 7 or 30 days. It contains only the number of days. The plugin keeps the answer for 15 minutes.
  • Every 30 days, a request to rotate the API keys.
  • When you disconnect or delete the plugin, a request to revoke the site’s keys. On deletion this request also contains the site URL, site name, admin email address, and plugin version.

After you connect, Aranx also calls the plugin’s REST API on your site. All of these calls require the site’s API key. Aranx uses them to:

  • Create, update, and delete the posts it publishes, and upload their images
  • Read posts, categories, media, and authors (ID, display name, role, and avatar URL), so you can pick a category and author in Aranx
  • Read the connection status: site name and URL, WordPress, PHP, and plugin versions, and which SEO plugins are active

The plugin downloads article images over HTTPS from images.aranx.com and from other public image URLs that Aranx sends with an article. It adds them to your media library.

Installation

  1. Upload the aranx-connector folder to /wp-content/plugins/
  2. Activate the plugin through the Plugins menu in WordPress
  3. Go to Aranx in your admin sidebar
  4. Click Connect to Aranx and authorize your site

FAQ

Do I need an Aranx account?

Yes. This plugin is a connector between your WordPress site and the Aranx platform. Create an account at aranx.com.

What happens to my content if I deactivate the plugin?

All published content remains on your site. Deactivating pauses the connection to Aranx. Reactivating restores it automatically.

Does this work with my SEO plugin?

Yes. If Yoast SEO or Rank Math is active, Aranx saves the article’s meta title and description in that plugin’s fields. With neither active, Aranx prints them itself.

Is the connection secure?

All communication uses HTTPS with separate, revocable API keys for each direction. Browser callbacks carry only a short-lived authorization code. Webhooks, heartbeats, and image-transfer callbacks are HMAC-signed. API keys are encrypted in non-autoloaded WordPress options.

Changelog

1.7.0

  • New Aranx admin: Overview, Articles, Activity, AI visits, SEO, Connection, and Diagnostics pages, with a history of connection checks and Aranx requests. Image import failures show the cause, with Retry and Dismiss
  • The AI visits page shows which AI bots read your site in the last 7 or 30 days, and which pages they read
  • Counts the people who open your site from a link in ChatGPT, Perplexity, Gemini, Claude, or Copilot, for Aranx AI Visibility. A small script on public pages reports these visits to your site’s REST API, so pages that a page cache or a CDN serves count too
  • Sites behind a proxy other than Cloudflare should set the aranx_ai_traffic_client_ip filter. Without it, their visitors share one limit of 30 visit reports per 10 minutes

1.6.0

  • Counts the visits of AI search bots and AI answer fetchers (ChatGPT, Claude, Perplexity) and sends them to Aranx every 5 minutes for AI Visibility. Pages that a page cache serves are not counted
  • Reads the client IP from REMOTE_ADDR, or from CF-Connecting-IP when the request comes from Cloudflare and not from another site’s Worker. Sites behind another proxy can set it with the aranx_ai_traffic_client_ip filter

1.5.1

  • Sends its requests to api.aranx.com and opens the connection page on app.aranx.com. No change in features

1.5.0

  • Tells Aranx about an edit to an Aranx post at the end of the save, so Aranx updates its copy within seconds. A failed send stays in the outbox, and cron retries it
  • Writes an Aranx update only when the post is still the version Aranx read. If you changed the post since, nothing is overwritten
  • Never writes to a post that has a newer autosave or a PublishPress revision that is not published yet
  • Lets Aranx read one post, and list posts with a fingerprint instead of the full text

1.4.1

  • Links image blocks in posts sent before Aranx wrote attachment IDs to their Media Library image, so the editor no longer offers to upload them again
  • Fixes Aranx image blocks that the editor reported as invalid content
  • Keeps embeds and other HTML that an administrator saved when it updates a post in the background
  • Tries every image of a post before it retries one that failed, and waits a week before it tries again an image that keeps failing
  • Never reuses an image that another upload is still processing
  • Keeps the image link setting and the Media Library alt text

1.4.0

  • Moves article images that are still on the Aranx image server into the Media Library, then links each image block to its attachment
  • Runs in the background after Aranx sends a post and after each save, and once a day for older posts
  • Stops the editor from offering to upload these images, an upload that failed with “Upload failed, try again”

1.3.3

  • Accepts only the one-time authorization code on the connect callback, never API keys in the URL
  • Sends only post and page counts in the hourly heartbeat, not user counts or server details
  • Translates the connection notices
  • Lists every request to and from Aranx under External services

1.3.2

  • Parses URLs with wp_parse_url()
  • Tested with WordPress 7.1

1.3.1

  • Keeps backslashes in post titles and content
  • “Publish now” publishes a scheduled post instead of keeping it scheduled
  • Keeps private posts private when Aranx changes their date
  • Reports a wrong server clock as clock skew instead of disconnecting the site
  • Shows connection notices only to administrators, only on the Dashboard and Plugins screens, and lets them be dismissed
  • Makes no requests to Aranx before you connect
  • Removes every scheduled task on deactivation and uninstall
  • Lists all data sent to Aranx in this readme

1.3.0

  • Queues post changes while the site is disconnected and sends them after it reconnects
  • Keeps retrying webhooks that failed for network, server, or auth reasons instead of dropping them
  • Sends the current site identity with each delayed webhook

1.2.0

  • Encrypts API keys and pending authorization credentials at rest
  • Adds automatic and manual two-phase WordPress API key rotation
  • Signs outbound webhooks and heartbeats and adds replay identifiers
  • Removes author email addresses from the users response
  • Hardens production builds, callback privacy, SSRF checks, logs, and admin output

1.1.0

  • Activates confirmed connections without depending on WordPress cron
  • Adds durable webhook and image-transfer queues with safe retries
  • Preserves updates for legacy Aranx and BlogEmpire-generated posts
  • Improves authorization, reconnection, and credential-rotation safety
  • Adds WordPress 5.0-compatible one-off cron scheduling

1.0.0

  • Initial release
  • One-time authorization-code exchange with paired API keys
  • Automatic content publishing via webhooks
  • Post status synchronization
  • SEO meta tag output (when no SEO plugin is active)
  • Connection health monitoring with auto-reconnection
  • Activity logging and debug tools