Oscar SEO Connector

Wopisanje

Oscar SEO Connector replaces the Application Password flow that Oscar previously used to publish to self-hosted WordPress sites.

Instead of a broad, account-wide Application Password, this plugin issues a single, narrow connection token that Oscar uses to call a small, dedicated REST API:

  • Verify the connection (ping).
  • Create or update a post, including title, content, excerpt, slug, status, categories, tags and a meta description (publish).
  • Upload an image to the media library, from a URL or a direct file upload, for use as a featured or inline image (media).
  • Optionally remove a post that Oscar created (post/{id}).

Security first

  • The connection token is generated with a cryptographically secure random source and only its hash is ever stored in the database. The plaintext is shown exactly once, right after it is generated.
  • Every request is authenticated with a Bearer token compared using a constant-time (hash_equals) check — no valid token, no access.
  • Every REST route has an explicit permission check; none are public.
  • All admin actions are nonce-protected and require the manage_options capability.

SEO plugin compatibility

When present, the meta description Oscar sends is also written to the fields read by Yoast SEO and Rank Math, in addition to the plugin’s own field, so existing SEO plugins keep working without any extra configuration.

External services

This plugin connects your WordPress site to Oscar SEO (https://oscar-seo.ai), a third-party content platform that you must have an account with. The connection is initiated by you: you install this plugin, generate a connection token, and paste it into your Oscar account.

What data is exchanged and when:

  • Oscar calls this site’s REST API (the oscar/v1 endpoints) using the connection token you provide, to verify the connection and to create or update posts (title, content, excerpt, slug, status, categories, tags, meta description).
  • When a post includes images, the plugin downloads those images from the URLs Oscar provides and adds them to your Media Library.
  • The plugin itself does not send your site’s data to Oscar and does not track your site or its visitors. All requests are initiated by Oscar using the token you authorized, and the connection can be revoked at any time by regenerating or removing the token.

By connecting, you agree to Oscar SEO’s Terms of Service (https://oscar-seo.ai/cgv) and Privacy Policy (https://oscar-seo.ai/confidentialite).

Instalacija

  1. Upload the oscar-seo-connector folder to /wp-content/plugins/, or install the zip file through Plugins Add New Upload Plugin.
  2. Activate the plugin through the Plugins screen.
  3. Go to Oscar SEO in the admin menu.
  4. Copy the REST base URL and the connection token shown there (the token is only shown once).
  5. Paste both values into Oscar’s WordPress connection settings.
  6. Oscar calls GET /oscar/v1/ping to confirm the connection; the status on this page will switch to „Connected“ after the first successful request.

HSP

Where is my connection token stored?

Only a SHA-256 hash of the token is stored in the WordPress options table. The plaintext token is never persisted; it is shown once, immediately after it is generated or regenerated, and cannot be retrieved afterwards. If you lose it, use Regenerate.

What happens if I regenerate the token?

A brand-new token is generated and its hash replaces the old one. Any system still using the previous token will immediately get 401 Unauthorized responses. Update Oscar with the new token right away.

Does this work with Yoast SEO or Rank Math?

Yes. If either plugin is active, the meta description sent by Oscar is also written to that plugin’s own meta key. If neither is active, nothing extra happens — there are no fatal errors either way.

Does this plugin send any data anywhere on its own?

No. It does not phone home, it does not track the site or its visitors, and it schedules no background outbound requests. It only responds to authenticated requests initiated by Oscar (or by anyone holding a valid token). The one outbound network request it can make is downloading an image into the media library, and only when an authenticated request explicitly supplies that image URL (featured_image_url on publish, or source_url on the media endpoint) — the standard WordPress media sideload. No site data is ever sent to Oscar or any third party by the plugin itself.

Can I still use Application Passwords alongside this plugin?

Yes, they are independent. This plugin adds its own narrow, token-based API rather than replacing WordPress’s core REST authentication.

Pohódnoćenja

Za tutón tykač pohódnoćenja njejsu.

Sobuskutkowarjo a wuwiwarjo

„Oscar SEO Connector“ je softwara wotewrjeneho žórła. Slědowacy ludźo su k tutomu tykačej přinošowali.

Sobuskutkowarjo

Protokol změnow

1.0.0

  • Initial release: connection token management, oscar/v1 REST API (ping, publish, media, delete), settings screen, Yoast/Rank Math meta description support.