描述
The SEO Agent is an AI SEO content automation platform. It does keyword research with real DataForSEO data (not estimates), drafts fact-checked articles with citations, runs them through a quality gate, and ships them to your CMS. This plugin is the WordPress receiver: every article you approve in the dashboard lands on your site as a published post.
What gets published
- Article title
- Full HTML body
- Featured image (downloaded into your WordPress media library)
- SEO meta description (Yoast and Rank Math compatible)
- Tags (auto-created if they do not exist)
- Custom slug
How it works
- Sign up at theseoagent.ai and create a WordPress integration in your dashboard. The dashboard generates a 64-character integration token.
- Install and activate this plugin on your WordPress site.
- Paste the token at The SEO Agent in your admin sidebar (the plugin opens this page automatically after activation) and click Save.
- Approve an article in the dashboard. The SEO Agent posts it to your site over HTTPS using the token.
The plugin exposes two REST routes under the seobot/v1 namespace:
POST /wp-json/seobot/v1/pingfor the dashboard’s “Test Connection” buttonPOST /wp-json/seobot/v1/articlesfor the publish payload
Both routes require the bearer token. The plugin compares it to the saved token using a constant-time comparison so nothing leaks via timing.
No telemetry. The plugin does not phone home. It only responds to requests your dashboard initiates.
External services
This plugin connects WordPress to a third-party SaaS, The SEO Agent (theseoagent.ai), which is required for the plugin to do anything useful.
What data is sent and when
- The plugin receives
POST /wp-json/seobot/v1/articlesrequests fromtheseoagent.aionly when you click “Approve” on an article in the dashboard. The payload contains the article body, title, tags, slug, meta description, and a featured-image URL. - The plugin makes outbound HTTPS requests only to fetch the featured-image URL provided in the payload (via WordPress core’s
media_sideload_image). No tracking pixels, no analytics calls. POST /wp-json/seobot/v1/pingrequests come from the dashboard’s “Test Connection” button. The response includes plugin version, WordPress version, site name, and site URL so the dashboard can confirm the integration is live.- No data is sent to The SEO Agent on plugin activation, page loads, or any background WordPress event.
Account, billing, and policies
- Using this plugin requires a paid account on The SEO Agent. Pricing: $1 trial for 3 days, then $99/mo. See theseoagent.ai/pricing.
- Terms of Service: theseoagent.ai/terms
- Privacy Policy: theseoagent.ai/privacy
安装
- In WordPress Admin, go to Plugins → Add New → Upload Plugin and upload the
.zip. Or copy theseobot/folder intowp-content/plugins/. - Activate The SEO Agent. The plugin will open its setup page automatically.
- Paste the integration token from your dashboard at theseoagent.ai/integrations.
- Choose your post mode: Publish immediately (default) or Save as draft if you want to review before publishing.
- Click Save settings.
- Back in the dashboard, click Test Connection & Create Integration.
常见问题
-
Where do I get the integration token?
-
Sign up at theseoagent.ai, then create a WordPress integration in your dashboard. The token is shown to you once at create time. Copy it before leaving the page. If you lose it, recreate the integration (we cannot recover it).
-
How does authentication work?
-
Every request to the plugin’s REST endpoints must include an
Authorization: Bearer <token>header. The plugin compares the provided token to the saved one usinghash_equals(constant-time comparison). -
Can I run articles in draft mode?
-
Yes. Open The SEO Agent in your WordPress admin sidebar, set Post mode to “Save as draft (review before publishing)”, and click Save. From that point every approved article lands as a WordPress draft, ready for you to review in Posts → All Posts before publishing.
-
Does it support custom post types?
-
Version 1 publishes to the standard
posttype. Custom post type support is planned. -
What if my site is behind Cloudflare or a security plugin?
-
The dashboard’s “Test Connection” gives your site 15 seconds to respond. If a security plugin (Wordfence, Sucuri, iThemes Security) or Cloudflare Bot Fight Mode is challenging POST requests to
/wp-json/seobot/v1/*, whitelist that namespace. -
Does the plugin track me or send analytics?
-
No. The plugin does not collect telemetry. The only outbound HTTP it makes is fetching the featured-image URL we send in the publish payload (so the image lands in your media library).
-
Where can I see what is being sent?
-
The dashboard shows every publish attempt with the exact payload. The plugin’s setup page also shows the most recently received article (title, timestamp, link to edit) so you can confirm the integration is alive without leaving WordPress. You can also tail your WordPress access log for
POST /wp-json/seobot/v1/articles.
评价
此插件暂无评价。
贡献者及开发者
更新日志
1.3.0
- Republish now updates the live WordPress post instead of creating a duplicate. When you edit an article in the dashboard and re-send, the plugin looks up the previously published post via the
_seobot_external_idmeta key and updates the title, content, slug, tags, meta description, and featured image in place. - Recreate fallback: if the linked WordPress post has been deleted, the plugin transparently creates a new post and the dashboard surfaces this as
action: recreated. - No breaking changes. The REST namespace
seobot/v1, the publish payload shape, and saved option keys are unchanged. Existing installs upgrade in place.
1.2.0
- Rename plugin display name to “Seobot Publisher for The SEO Agent” and text domain to
seobot-publisher-for-the-seo-agentper WordPress.org plugin directory review feedback. - Move top-level admin menu position from 25 to 80 so it sits with Settings/Tools rather than alongside core post-management items.
- Update Contributors metadata.
- No functional or API changes. The REST namespace
seobot/v1and saved-option keys are unchanged, so existing installs upgrade in place without reconfiguration.
1.1.1
- Fix dashboard URL shown in plugin settings page and readme. The link now correctly points to https://theseoagent.ai/integrations (no
app.subdomain).
1.1.0
- Top-level admin menu item “The SEO Agent” with custom icon, replacing the old Settings sub-menu.
- Auto-redirect to the setup page on activation. No more hunting through admin menus after install.
- Branded setup page with cobalt header, status card, settings card, last-received-article card, and REST endpoints reference.
- Post mode toggle: choose Publish Immediately (default) or Save As Draft. Draft mode lets you review approved articles in WP before they go live.
- Last received article card shows the most recent successful publish (title, timestamp, edit + view links) so you can confirm the integration is alive from the WordPress side.
- Ping endpoint now also returns the configured post mode.
1.0.0
- Initial release. Settings page with token field. Two REST routes:
ping(health check) andarticles(publish). Featured-image download viamedia_sideload_image. Tag creation viawp_set_post_tags. Meta description compatible with Yoast (_yoast_wpseo_metadesc) and Rank Math (rank_math_description). Custom slug support. Constant-time token comparison.
