Connect Your Site to Kyni

Connect Your Site

Kyni works with WordPress and Git-based sites (Astro, Hugo, Next.js, Jekyll, Gatsby, and more). Choose your platform below.

WordPress

Requirements

• WordPress 6.0 or higher
• Admin access to the site

Installation

1. In Kyni, click Add Site and select WordPress
2. Enter your site’s URL (e.g., https://yoursite.com)
3. Click Generate Connection Token
4. Copy the token shown on screen
5. Log in to your WordPress admin at https://yoursite.com/wp-admin
6. Go to Plugins → Add New
7. Search for Kyni SEO
8. Click Install and then Activate
9. Go to Kyni SEO → Settings in your WordPress admin
10. Paste the connection token from Kyni
11. Click Connect

You’ll see a Connected status when it’s successful. The plugin will now sync your content and accept publishing commands from Kyni.

What the plugin does

• Receives published articles from Kyni and posts them to WordPress
• Tracks when you manually delete or modify posts in WordPress
• Syncs keyword rankings data from Google Search Console
• Monitors your site’s internal link structure

The plugin never edits or deletes content without your permission.

Git-Based Sites (Astro, Hugo, Next.js, etc.)

Requirements

• A GitHub repository (public or private)
• Git-based site (Astro, Hugo, Next.js, Jekyll, Gatsby, or custom)
• Site must be deployed (Kyni will detect framework and file structure)

Authentication Methods

You have two options:

Option 1: GitHub App (Recommended)

• Easier and more secure
• Kyni requests only what it needs
• One-click authorization

Option 2: Personal Access Token (PAT)

• Manual setup
• More control over permissions
• Good if you prefer not to use OAuth

Installation (GitHub App)

1. In Kyni, click Add Site and select Git
2. Click Connect with GitHub App
3. You’ll be taken to GitHub to authorize Kyni
4. Review permissions (read repo, commit/push to specified branches)
5. Select which repositories Kyni can access
6. Click Install
7. Back in Kyni, enter:
   • Repository (auto-filled if you just installed)
   • Branch (e.g., main, master)
8. Click Detect Framework
9. Kyni will scan your repo and auto-detect:
   • Framework (Astro, Hugo, Next.js, etc.)
   • Content directory (where your articles live)
   • Image directory (where featured images are stored)
   • File format (Markdown, MDX, etc.)
10. Review the detected settings and adjust if needed
11. Click Connect

Installation (Personal Access Token)

1. In Kyni, click Add Site and select Git
2. Click Use Personal Access Token
3. Go to GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens
4. Click Generate new token
5. Set permissions:
   • Repository access: select your site repo
   • Permissions:
     • contents: read and write (Kyni needs to commit articles)
     • metadata: read (standard, always required)
6. Click Generate token and copy it
7. Paste into Kyni
8. In Kyni, enter:
   • Repository URL (e.g., https://github.com/yourname/yoursite)
   • Branch (e.g., main)
9. Click Detect Framework
10. Review auto-detected settings
11. Click Connect

What Kyni does with Git sites

• Creates new files in your content directory (one per article)
• Commits changes with a clear message (e.g., “Publish article: My Article Title”)
• Pushes to your repository
• Creates a new git commit for each article publish (tracked in your git history)

Your deployment pipeline (GitHub Pages, Vercel, Netlify, etc.) automatically picks up the new commits and deploys.

Verify the connection

1. Return to Sites in Kyni
2. Look for your site in the list
3. You should see a Connected badge

If you see Offline or Not Found, check:

• WordPress: the plugin is installed and active
• Git: the token has write permissions to the repo
• Network: your site URL is publicly accessible

Next: Run your first audit

Once connected, head to your site’s Audit tab to analyze your current SEO health.