WordPress integration

GEOHATS for WordPress: auto-publishing and an AI SEO plugin

In short: GEOHATS connects to WordPress with an Application Password and publishes its pages as posts, either as drafts or live. The free GEOHATS Connector plugin adds one-click site fixes (titles, meta descriptions, canonicals, JSON-LD, alt text and internal links), written into Yoast SEO, Rank Math or on their own, each with undo.

Connect WordPress with an Application Password

Application Passwords are built into WordPress. They let a tool use the REST API as one user without knowing that user’s login password, and you can revoke them one by one.

  1. In WordPress, go to Users → Profile. Use an Administrator account for the best results (see roles below).
  2. Under Application Passwords, name it GEOHATS and click Add.
  3. Copy the password WordPress shows. The spaces in it do not matter.
  4. In GEOHATS, open the website, go to Integrations, pick WordPress and enter the site URL, the WordPress username and the Application Password. The IndexNow key is optional (see below).

What GEOHATS checks before it saves the connection:

Connection settings are stored encrypted. The Test connection button in Integrations runs the same check again at any time.

Which WordPress role to connect

WordPress filters post content through kses. For any user without the unfiltered_html capability it removes <script> (which includes the JSON-LD block), <style> and SVG from the post. The article text, headings, tables and links survive, but the structured data does not.

What happens with each WordPress role
RoleCan GEOHATS publish?JSON-LD and styling kept?
AdministratorYes, live or draftYes on a single site. On multisite only Super Admins have unfiltered_html.
EditorYes, live or draftYes on a standard single site; no on multisite or on hosts that remove unfiltered_html
AuthorYes, live or draftNo
ContributorNo. Refused at connect when WordPress reports capabilities; otherwise posts land as Pending reviewNo

GEOHATS shows this warning when you connect. If schema matters to you, and for AI search it does, connect an Administrator.

How publishing works

What gets posted

GEOHATS posts the article body, not the whole standalone HTML document, so the page renders inside your theme. It removes the document head, executable scripts, style blocks, HTML comments and any leftover placeholder markers, and keeps the JSON-LD block. Root-relative internal links such as /pricingare rewritten to full URLs on your site’s domain. Only pages that passed the quality gate can be published.

Draft or live

Clicking Publish on a page in the dashboard publishes it live. For new pages, the website’s auto-publish mode decides: Off, Send as draft or Publish live (details on the integrations page). GEOHATS trusts what WordPress reports back: if WordPress saves the post as a draft or as pending review, GEOHATS records it that way and does not claim it is live. The MCP server’s publish_page tool reports the same real status to your coding agent.

Republishing updates the same post

The optional IndexNow key

IndexNow is a protocol that tells participating search engines, including Bing, that a URL is new or changed. If you enter a key when connecting, GEOHATS sends the live URL to IndexNow each time a post goes live, using your key. The protocol requires you to host a text file named after the key, containing the key, at your site root (https://yoursite.com/<key>.txt). Without a key, nothing is sent and search engines find the post through your sitemap as usual.

The GEOHATS Connector plugin

The site optimizer crawls your site the way AI crawlers do and suggests fixes. Core WordPress cannot write SEO plugin fields, alt text inside content or JSON-LD over its REST API, so applying those fixes needs a small companion plugin. It is free and open source (GPLv2).

  1. Download geohats-connector.zip.
  2. In WordPress: Plugins → Add New → Upload Plugin, choose the zip, Install, Activate.
  3. Connect WordPress in GEOHATS (above) if you have not yet.
  4. In the site optimizer, open Fixes, select the fixes you want and click Apply.
How the Connector plugin writes each fix
FixWith Yoast SEO or Rank MathWith no SEO plugin
Page titleWritten into the SEO plugin's own title fieldThe plugin sets the document title
Meta descriptionWritten into the SEO plugin's description fieldThe plugin prints the meta description tag
Canonical URLWritten into the SEO plugin's canonical fieldThe plugin sets the canonical URL
FAQ and Article schemaPrinted as JSON-LD in the page headSame
Organization schemaPrinted as JSON-LD on the front pageSame
Image alt textUpdated in the Media Library and in the page contentSame
Internal linkWraps the first plain-text match of the anchor phrase in a link, skipping existing links, headings and codeSame

Limits: if your homepage shows your latest posts and you use an SEO plugin, set the homepage title and description in that plugin’s settings. Images that come from your theme rather than the content or Media Library cannot be changed. The plugin was tested against a real WordPress install with no SEO plugin, with Yoast SEO, and with Rank Math both configured and not yet configured.

Common errors and what they mean

WordPress connection errors
What GEOHATS saysUsual cause
WordPress didn't accept the username + application passwordWrong username, or the Application Password was revoked. Create a new one.
The WordPress REST API isn't reachableA security plugin (for example Wordfence) or a Disable REST API setting is blocking it, or the URL is wrong.
That URL responded but didn't return WordPress dataA cache, firewall challenge or coming-soon page is answering instead of WordPress.
This WordPress user can't publish postsThe account is a Contributor. Use an Editor or Administrator.
WordPress is temporarily unavailableThe site returned 429, 502, 503 or 504: rate limiting or maintenance. Try again later.
Install the GEOHATS Connector pluginA fix was applied before the plugin was installed and activated.

FAQ

Is there an AI SEO plugin for WordPress that works with Yoast or Rank Math?

The free GEOHATS Connector plugin writes titles, meta descriptions and canonicals into Yoast SEO or Rank Math when either is active, and prints them itself when neither is. It also adds FAQ, Article and Organization JSON-LD, image alt text and internal links. Every change can be undone from GEOHATS.

Do I need the plugin to publish posts?

No. Publishing posts only needs an Application Password, because it uses the standard WordPress REST API. The plugin is only for applying site optimizer fixes to existing pages, which core WordPress cannot do over REST.

Why is the JSON-LD missing from my published post?

WordPress removes script tags, style tags and SVG from post content saved by a user without the unfiltered_html capability. On a standard single-site install that is anyone below Editor; on multisite, everyone except Super Admins. Connect an Administrator account to keep the schema.

Will republishing overwrite the title or slug I changed in WordPress?

No. The first publish sets the title, slug and excerpt. Later publishes update only the content and status, so edits you make to the title or permalink in WordPress stay.

Can GEOHATS publish to WordPress automatically?

Yes. Set the website's auto-publish mode to Send as draft or Publish live. Each page GEOHATS generates is sent to WordPress as soon as it passes the quality gate. New connections start in Send as draft.

Does the plugin load JavaScript on my site?

No. It adds two REST endpoints and prints its tags in the page head on the server. AI crawlers such as GPTBot and ClaudeBot do not run JavaScript, so fixes have to be in the HTML the server sends.

Publish to WordPress from GEOHATS

WordPress publishing and the Connector plugin are included in every plan. You pay once and use your own AI keys.

See pricing

Last updated