Integrations & SDKs

Every Kaonic Ai Beta capability is reachable over plain JSON. Where a wrapper makes the job easier, Kaonic ships one: a WordPress plugin for publishing sites, a dependency-free PHP SDK for SEO automation, and webhooks so your service hears about events instead of polling.

WordPress — the kaonic-seo plugin

The plugin connects a WordPress site to Kaonic so meta tags can be written and AI content published without leaving the terminal or your dashboard.

DetailValue
Plugin nameKaonic SEO (kaonic-seo)
Version1.0.0
RequiresWordPress 6.0+, PHP 8.0+
Source folderkaonic-mvp/wordpress-plugin/kaonic-seo
Settings pageSettings → slug kaonic-seo
Stored key optionkaonic_seo_api_key

Install

  1. Copy the kaonic-seo folder into wp-content/plugins/.
  2. Activate Kaonic SEO in the WordPress admin. Activation generates a 48-character key automatically, so the site is ready to connect.
  3. Open the plugin settings page and copy the key (regenerate it there if it ever leaks).
  4. Give that key to Kaonic — for example as the API key of the site you register for SEO automation.
curl -X GET https://your-site.test/wp-json/kaonic/v1/ping \
  -H "X-Kaonic-Key: <plugin key>"
{
  "ok": true,
  "plugin": "kaonic-seo",
  "version": "1.0.0",
  "site_name": "My Business",
  "home_url": "https://your-site.test"
}

REST bridge

The plugin exposes a small namespace at /wp-json/kaonic/v1/. Every route is guarded by the X-Kaonic-Key header, and an invalid key answers 401 kaonic_unauthorized.

RouteMethodPurpose
/wp-json/kaonic/v1/pingGETConnection test: plugin version, site name, home URL.
/wp-json/kaonic/v1/metaPOSTWrite meta_title and meta_description for the post behind a URL.
/wp-json/kaonic/v1/contentPOSTCreate or update a post from Kaonic-generated title, body and meta.
curl -X POST https://your-site.test/wp-json/kaonic/v1/meta \
  -H "X-Kaonic-Key: <plugin key>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-site.test/our-services",
    "meta": {
      "meta_title": "Solar Installation in Kampala | My Business",
      "meta_description": "Certified solar installers serving Kampala and Entebbe."
    }
  }'
/meta resolves the URL to a post; if nothing matches it answers 404 kaonic_post_not_found. /content creates the post as a draft unless you send "status": "publish".

PHP SDK — kaonic/seo-sdk

A thin, dependency-free HTTP client for the Kaonic SEO surface (keywords, content, competitors, trends, recommendations, automation and WordPress). It needs only ext-curl and ext-json.

DetailValue
Packagekaonic/seo-sdk
RequiresPHP 8.1+
AutoloadPSR-4 — Kaonic\ → src/
Source folderkaonic-mvp/sdk/php

Install

Add the SDK to your project with a Composer path or VCS repository pointing at kaonic-mvp/sdk/php, then require it:

composer require kaonic/seo-sdk

Use

<?php
require __DIR__ . '/vendor/autoload.php';

use Kaonic\KaonicClient;

$kaonic = new KaonicClient(
    'https://ai.gatavase.com',
    getenv('KAONIC_API_KEY'),        // GK_… private key or bearer token
    ['timeout' => 30]
);

$sites = $kaonic->sites->list();

echo json_encode($sites, JSON_PRETTY_PRINT);

The client exposes one property per resource group:

PropertyCovers
$kaonic->sitesConnected websites.
$kaonic->keywords / $kaonic->globalKeywordsKeyword research and tracking.
$kaonic->contentAI content generation and publishing.
$kaonic->competitors / $kaonic->trendsCompetitor and trend analysis.
$kaonic->recommendationsOptimisation opportunities.
$kaonic->automationAutonomous optimisation runs.
$kaonic->wordpressTalking to a connected WordPress site.
$kaonic->multilingualAfrican-language content.

Webhooks

Subscribe an HTTPS endpoint and Kaonic posts to it when something happens, instead of you polling. Create a webhook with a name, a URL and one or more supported events; Kaonic answers with a signing secret (whsec_…) that is shown once.

EventFires when
seo.audit.completedAn SEO audit for a connected site finishes.
agent.message.completedThe AI agent completes a message or briefing.

Any other stack

If there is no wrapper for your language, the REST API is the integration. Send X-Kaonic-Key with a private GK_… key and read JSON back:

curl -X POST https://www.ai.gatavaseug.com/api/v1/chat \
  -H "Content-Type: application/json" \
  -H "X-Kaonic-Key: $KAONIC_API_KEY" \
  -d '{"message":"Draft a WhatsApp promotion for my restaurant","conversation_id":null}'

Next steps