AI Suggestions

This is the heart of Linkilo. It scans your posts, finds the best internal-link opportunities, and lets you approve them one click at a time.

What this is

Linkilo reads your posts, figures out which posts relate to each other, and suggests where you could add a link. For each suggestion you get:

• Source post — the post the link would be added IN
• Target post — the post it would link TO
• Anchor text — the words on the source post that become clickable
• Confidence score — how sure Linkilo is (higher = better match)

You then click Apply to add the link, Reject to skip, or Customize Anchor to change the anchor text first.

Configure AI Settings (one time)

Go to Linkilo → Settings → AI Settings (under the Smart Linking group).

You'll see a page titled "Linkilo AI Settings" with three tabs: AI Settings, Related Posts, Topic Clusters. Stay on AI Settings.

Core AI Configuration

• OpenAI API Key — paste your sk-... key. Two buttons next to it: Test API Key (verifies it works) and Revoke API Key (wipes the key from Linkilo).
• AI Model — pick which OpenAI model to use. Default is GPT-4.1 Mini (best $/quality). Other options grouped by Recommended / Modern / Budget / Legacy / Reasoning, each with estimated cost per 1,000 posts.
• Embedding Model — defaults to text-embedding-3-large. Budget alternative: text-embedding-3-small (6× cheaper, ~5% less accurate).
• Suggestion Quality Threshold — slider from "More Suggestions" to "Higher Quality". 0.4–0.6 is balanced.
• Max Suggestions per Post — 10–15 is balanced.
• Default Batch Size for Processing — 3 / 5 / 8 / 10 posts. 3 is safe default.
• Enable Auto-Linking — toggle for automatic link insertion when posts are saved.
• Intent-Based Smart Linking — toggle for intent-aware suggestions.

AI Rules & Guidelines

Custom rules the AI follows. Click + Add New Rule and define name + value + description. Examples: "max 5 links per section", "prioritize cornerstone content", "avoid linking from About page".

AI Automation

The set-and-forget features:

• Analyse on publish — every time you publish or update a post, Linkilo scans it.
• Weekly site sweep — once a week, Linkilo finds posts that haven't been analysed recently. Runs Monday 2 AM.
• Max posts per sweep — caps the sweep size.
• Smart Autopilot — adaptive scheduler that picks the best moments to re-analyse.
• Auto-apply high-confidence — insert suggestions above your threshold without manual review. Requires Autopilot.
• Confidence threshold — 90%+ (very conservative), 80%+ (recommended), down to 50%+ (aggressive).

AI Content Processing & Analysis

Live stats: Total Posts, Processed, Pending, Errors, Total API Calls, Total Cost. Plus a Reset All AI Data danger button.

Don't forget Save Settings at the bottom.

Run a manual scan

Go to Linkilo → AI Suggestions in the sidebar.

The action bar

• Run Now — start a manual scan
• Stop Processing — cancel an in-flight scan
• Load Recent Session — re-load the last completed session's suggestions
• Refresh — re-fetch the suggestion list
• Clear All Suggestions — wipe ALL pending suggestions
• Debug Mode — toggle for diagnostic logging

Processing Settings card

Controls that apply to both manual runs and Autopilot:

• Autopilot toggle (same as the one in Settings)
• Auto-apply suggestions above [X]% confidence
• Max Posts to Process per run
• Max Suggestions per Post
• Minimum Confidence Level — filter weak suggestions out
• Post Types — checkboxes (Posts, Pages, and any custom types)
• Categories — limit to specific categories
• Exclude Recently Processed Posts — off by default for manual runs
• Follow AI Rules from Settings — on by default

Click Start Processing to kick it off.

Reviewing suggestions

Each suggestion shows source title + target title + sentence context with the anchor highlighted + confidence pill. Use the Show: dropdown above the list to paginate.

For each one: Apply, Reject, or Customize Anchor.

Per-post suggestions (in the editor)

If you only want suggestions for one specific post:

1. Open the post for editing.
2. Scroll to the AI Link Suggestions metabox below the main editor.
3. Two tabs at the top: AI Suggestions (with OPENAI badge) and Legacy Suggestions (with FREE — NO API KEY badge).
4. Click the tab you want, then Get AI Suggestions or Get Legacy Suggestions.

Below the engine cards are four pill toggles labelled "Suggest based on:" — Title, Keywords, Categories, Previous anchors. Tick which signals to use for this post.

Autopilot — Linkilo works while you sleep

Two places to flip the switch:

1. On the AI Suggestions page — toggle Autopilot in the Processing Settings card.
2. In Settings → AI Settings → AI Automation — toggle Smart Autopilot.

Both control the same setting.

Autopilot processes 5 posts at a time, every few minutes, in the background. A 500-post site usually completes its first pass in 24–48 hours. Survives PHP timeouts and server restarts.

Auto-Apply — the most powerful mode

Linkilo only auto-applies when ALL of these are true:

• AI confidence meets or exceeds your threshold
• The anchor text is healthy (not overused, not generic)
• No existing link conflicts with that spot
• The semantic verifier says "yes, this makes sense"

To turn it on: set the Auto-apply suggestions above [X]% slider on the AI Suggestions page, or use Settings → AI Settings → AI Automation → Auto-apply high-confidence.

Track auto-applied links on Linkilo → Dashboard and Linkilo → URL Records.

AI Rules Impact

On the AI Suggestions page there's an AI Rules Impact panel showing how many rules are active and how many candidates each rule blocked, boosted, or penalized in the last run. Click any rule to toggle it without leaving the page.

Common Questions

My scan returned zero suggestions

Lower the Minimum Confidence Level to 0.3. Check that your posts have at least 200–300 words. Verify your OpenAI key with Test API Key. Make sure your Post Types filter includes the right types.

How much does an AI scan cost?

Pennies per post. A 500-post first pass typically costs $2–10 on GPT-4.1 Mini.

Can I scan only one post?

Yes. Open the post, find the AI Link Suggestions metabox, click Get AI Suggestions.

Autopilot has been running but I see no new suggestions

Check the Autopilot Active panel at the top of AI Suggestions. If Last run is hours/days old, your WordPress cron may be broken. See Troubleshooting.

I rejected a suggestion but it came back

After 3 rejections of the same source→target pair, it's hard-blocked forever. Until then, similar suggestions may come back.