Skip to main content

LinkCentral Integration

Tier: AI-Powered — Full admin experience with deep AI features. You pick which AI provider and model to use for keyword matching and enrichment; SyteOps runs the work in the background with built-in quality gating.

SyteOps integrates with LinkCentral to automatically insert keyword links and internal cross-links into your WordPress posts. When combined with the ContentPen publishing workflow, links are inserted automatically as posts are created — no manual editing required.

The result: every article gets relevant affiliate links, product links, and internal cross-links inserted in natural positions, with proper SEO attributes, all controlled by your LinkCentral link library and SyteOps settings.

What It Does​

When you trigger the LinkCentral integration on a post, SyteOps:

  • Scans the post content for keywords that match links in your LinkCentral library
  • Inserts those links with the correct nofollow and sponsored attributes
  • Finds related posts on your site and adds internal cross-links to strengthen your SEO
  • Respects density limits so your content reads naturally — no link spam

Requirements​

  • SyteOps installed and activated
  • LinkCentral installed and activated on the same WordPress site
  • FlowMattic installed and activated (for workflow automation)

Setup​

1. Enable the Integration​

  1. Navigate to the Integrations tab in SyteOps settings
  2. Find LinkCentral in the SEO & Content category
  3. Toggle it ON
  4. Click Save Changes

2. Configure Settings​

  1. Go to the System / API tab
  2. Scroll to the LinkCentral Auto-Linking card
  3. Open the API & FlowMattic section (at the bottom of the card) and set your API Token — this is a password that FlowMattic will use to authenticate when calling the endpoint. Choose any strong random string (e.g., generate one with a password manager)
  4. Adjust the linking settings to your preference (see Settings Reference below)
  5. Click Save Changes

The API & FlowMattic section also shows the Process Links Endpoint URL. Copy this — you'll need it for the FlowMattic step.

3. Add the FlowMattic Workflow Step​

This step adds automatic link processing to your content publishing workflow. Add it after the step that creates the WordPress post.

  1. Open your FlowMattic workflow (e.g., the ContentPen Publishing Workflow)
  2. Find the step that creates the WordPress post (the one that outputs a post_id)
  3. Add a new step after it
  4. Choose API by FlowMattic as the app
  5. Configure the step:
FieldValue
MethodPOST
API EndpointPaste the Process Links Endpoint URL from your SyteOps settings
AuthenticationBearer Token
TokenThe API token you set in step 2
Content-Typeapplication/json
  1. Set the request body to:
{"post_id": {wordpress_step.post_id}}

Replace {wordpress_step.post_id} with the actual FlowMattic variable reference from your post creation step (e.g., {wordpress10.post_id}).

  1. Save the workflow

The integration works with any FlowMattic workflow that creates or updates posts — not just ContentPen workflows.

Settings Reference​

SettingDefaultDescription
API Token—Authentication token for the REST endpoint. Set this to any strong random string and use the same value in FlowMattic.
Max LC Links per 500 Words3Controls link density. A 1,000-word post would get up to 6 keyword links.
Max Cross-Links per Post3Maximum internal links to related posts. Set to 0 to disable cross-linking.
First Occurrence OnlyOnWhen enabled, each keyword is linked only once (the first time it appears).
Open Links in New TabOffWhen enabled, auto-inserted links open in a new browser tab.
Cross-Link ModeHeuristicChoose between taxonomy-based matching (free, fast) or AI-enhanced scoring (requires an AI provider).
Min Word Gap50Minimum number of words between consecutive auto-inserted links. Prevents link clustering.
Keyword Matching ModeExact matchHow SyteOps finds keyword phrases in your post: Exact match links only when the keyword text appears as whole words. AI semantic match asks your configured LinkCentral AI to map each library keyword to a phrase that actually appears in the article (useful when wording differs). Fallback tries exact matching first, then uses AI only if no keyword links were inserted. AI modes need a valid AI provider and model for LinkCentral (same as cross-link AI).
LC Category FilterAllComma-separated LinkCentral category IDs. Leave empty to use keywords from all categories.
Cross-Link Post TypespostComma-separated post types to consider for cross-linking (e.g., post,page).

Large articles and keyword libraries (AI modes)​

When you use AI semantic match or Fallback, SyteOps may trim very long post text and very large keyword lists so the request stays within model limits. If that happens, the processing response includes a short warning explaining what was trimmed. You can split work across multiple posts or reduce the number of active keywords per category if you routinely hit these limits.

Keyword Enrichment​

Links in your LinkCentral library need keywords before the auto-linker can insert them into posts. If you have links with no keywords, or links whose keywords were added manually and you want AI to improve them, use the Enrich Keywords with AI tool.

Running Bulk Enrichment​

  1. Go to the System / API tab in SyteOps settings
  2. Scroll to the LinkCentral card — the Keyword Status & Actions section is open by default and shows your library at a glance: how many links are Enriched, Missing keywords, and Flagged for review
  3. Click Enrich Keywords with AI to start enriching all eligible links

SyteOps processes your eligible links in parallel, generating keyword phrases for each one based on the link title, destination URL, and optional additional context. Progress is shown in real time. Click Stop Enriching at any time to pause — already-enriched links are saved immediately.

When enrichment is complete, a summary shows how many links were enriched and lists any that were skipped with the reason.

For one-off refreshes or to test different models before committing them to your full library, you can enrich a single link from the link's edit screen in LinkCentral:

  1. Open any LinkCentral link (Links → Library → click a link)
  2. In the SyteOps Enrich Single Link panel, click Enrich Now to run with the defaults saved on the System / API tab, or expand the override controls first
  3. Override controls available per run:
    • Provider / Model (override) — choose a different AI provider or model for just this link (useful when comparing models side-by-side). The override dropdown is filtered to models the provider can actually serve, and for the Context AI step it is locked to Perplexity-capable providers (Perplexity, OpenRouter, Straico).
    • Max Tokens (override) — override the provider's max-output tokens for this run. A shortcut action sets the value to the model's maximum when the model exposes one.
  4. Click Enrich Now and watch the per-step feedback; the run uses the overrides for that link only

Overrides are not persisted — the next run of bulk enrichment uses the values saved on the System / API tab. Use single-link enrichment to evaluate a model before rolling it out to your whole library.

Single-link enrichment is also what powers Process All Flagged Keywords, so the same override values apply when you reprocess flagged links in bulk (below).

If links are marked as Flagged in the Keyword Status card, click Process All Flagged Keywords to run keyword generation again for every flagged link.

  • SyteOps uses the same single-link keyword processor it uses for manual one-off runs.
  • It uses the Enrich Single Link override controls for Context AI Model and Max Tokens while processing flagged links in bulk.
  • Progress is shown as each flagged link is processed.
  • When the run finishes, you get a summary of successes and failures so you can follow up on any links that still need review.

Enrichment checkboxes​

Before you click Enrich Keywords with AI, you can choose two independent options:

OptionWhat it does
Re-enrich existing AI-generated keywordsWhen checked, links that already have AI-generated keywords (including older links where the source was not recorded) are included so the AI can generate fresh keywords—for example after you change the enrichment model or custom prompt. When unchecked, those links are skipped; only links that still have no keywords are eligible, plus manual-keyword links if you enable the next option.
Include manually-edited keywords (overwrites manual edits)When checked, links whose keywords were edited manually in LinkCentral are included and will be replaced by new AI-generated keywords. You can use this on a normal run (without re-enrich) to target only new links and manual-keyword links, or together with re-enrich to refresh your whole library. SyteOps asks for confirmation before overwriting manual keywords. When unchecked, manual-keyword links are not overwritten on a normal run; on a re-enrich run they stay protected unless you check this box.

You can combine the checkboxes in any way that matches your goal. The status line above the button updates to show how many links are eligible for the combination you selected.

Enrichment Settings​

These settings live in the Enrichment Settings section of the LinkCentral card.

SettingDefaultDescription
Quality TierStandardControls the enrichment pipeline depth. Quick makes one AI call with no web context (10–15 keywords) — use for large libraries where speed matters and links are well-described. Standard adds a Perplexity context lookup (20–30 keywords) — the default and a good balance. Thorough makes two AI calls with Perplexity context (25–40 keywords) — use for high-value links where anchor-text quality matters more than cost or speed.
Target Keywords25The number of keywords to generate per URL (5–60). The quality tier caps this (Quick ≤ 15, Thorough ≤ 40); Standard uses the value as-is.
Batch Size1How many links each worker processes per request (1–50). Keep this low (1–5) when using multiple concurrent workers. Larger values reduce round-trips but increase the work done per request.
Concurrent Workers2Number of links processed in parallel (1–5). Increasing this speeds up large enrichment runs — for example, 3 workers process roughly 3× as fast as 1. Higher values consume more AI API quota simultaneously.
Context LayersAll onThree optional sources of context the AI uses to generate better keywords: Perplexity AI web search (looks up the destination URL to describe what the page offers), Page metadata fetch (reads Open Graph tags and JSON-LD from the destination URL), and LinkCentral categories (your link's assigned categories). Disabling layers speeds up enrichment at some cost to keyword quality.
Custom Prompt—Additional instructions appended to every AI keyword request. Use this to guide the style or focus of keywords (e.g., "Focus on buyer-intent phrases" or "Use UK English spelling").

Saving settings vs running enrichment​

You can change enrichment providers, models, batch size, context layers, and other controls on the System / API tab and run Enrich Keywords with AI right away. The plugin uses the values currently shown on that page for the enrichment run, even if you have not clicked Save Changes on the main SyteOps settings form. Click Save Changes when you want those values stored for the next time you load the settings screen.

How enrichment methods work:

  • Cross-Link AI: analyzes each destination link to identify the best internal cross-link opportunities. Recommended model type: standard chat models. Recommended models: GPT-5.4-mini, GPT-4o-mini, Claude Haiku.
  • Keyword AI: generates the actual keywords. Recommended model type: fast, lightweight chat models. Recommended models: GPT-5.4-mini, GPT-4o-mini, Claude Haiku.
  • Context AI: optional second model that uses Perplexity web search to gather information about each link destination before keywords are generated. Recommended model type: search-enabled models (Sonar family). Recommended models: Sonar, Sonar Pro. Only Perplexity, OpenRouter, and Straico can access Perplexity search models.

When web-search context is enabled, keyword enrichment runs in two AI steps (Context AI then Keyword AI). If something fails, messages identify which step had the issue when possible. If Context AI fails but keyword generation still completes, you may see a warning even though keywords were saved.

AI Providers​

All AI configurations for LinkCentral are managed in the AI Providers section of the LinkCentral card. Open this section to configure three independent areas:

AreaUsed for
Cross-Link AIScoring candidate posts for relevance and generating anchor text in AI-Enhanced cross-link mode. Recommended model type: standard chat models. Recommended models: GPT-5.4-mini, GPT-4o-mini, Claude Haiku
Keyword AIGenerating keyword phrases during enrichment. Recommended model type: fast, lightweight chat models. Recommended models: GPT-5.4-mini, GPT-4o-mini, Claude Haiku
Context AIFetching Perplexity web search summaries of destination sites before keywords are generated. Recommended model type: search-enabled models (Sonar family). Recommended models: Sonar, Sonar Pro. Only Perplexity, OpenRouter, and Straico can access Perplexity search models

You can also click Configure AI Provider in the card header to quickly set the primary AI configuration via the provider modal.

OpenRouter is recommended for all areas because it aggregates models from all major providers under a single API key.

Tips for Large Libraries​

  • Throughput settings: For most AI providers, start with Concurrent Workers: 3 and Batch Size: 1 for a good balance of speed and reliability. If you use Straico for keyword enrichment or for the context (Sonar) model, SyteOps locks both to 1 (proxy latency), trims how much web-search and page metadata is sent, uses a shorter keyword prompt for Straico, and if the provider still reports an oversize-context-style error, retries that link once with a minimal prompt (title, destination URL, and categories only)
  • If you see links skipped due to timeouts, SyteOps automatically retries each failed request once with a longer timeout before marking it as skipped
  • Run enrichment in smaller passes (using the stop button) if you want to review results incrementally
  • After enrichment, re-run your ContentPen publishing workflow on existing posts to pick up the new keywords

How It Works​

When the endpoint is called with a post ID:

  1. Load keywords — SyteOps reads your LinkCentral link library and builds an index of keywords mapped to their link URLs, SEO attributes, and density settings. Keyword enrichment uses layered context — combining Perplexity web search, page metadata, and link categories — to produce more accurate keyword matches.
  2. Clean previous runs — Any links from a previous auto-linking run are removed first, so the process always starts fresh. Manual links you added yourself are never touched.
  3. Scan paragraphs — The engine walks through your post content paragraph by paragraph, skipping headings, existing links, code blocks, and shortcodes.
  4. Insert keyword links — Depending on Keyword Matching Mode, SyteOps either matches whole words exactly, or uses AI to pick verbatim phrases from the article that correspond to your library keywords, then inserts links to the correct LinkCentral URLs with the right nofollow/sponsored attributes.
  5. Insert cross-links — Related posts are identified by shared categories and tags, and contextual links are placed in relevant paragraphs.
  6. Save — The updated content is saved back to the post (unless you used dry-run mode).

The process is idempotent: running it again on the same post produces the same result. It removes its own previous links before re-processing, so you can safely re-run it after updating your LinkCentral keywords.

Heuristic (Default)​

Finds related posts by looking at shared categories and tags. Posts that share more taxonomy terms with your article score higher. Recent posts get a small bonus.

This mode is fast, free, and works well for most sites. If shared taxonomy terms are sparse (for example, on lightly-categorised sites), the cross-linker also performs a title-keyword fallback — searching published posts for those of your library keywords that match the current article's subject — so cross-link coverage stays useful even without deep category assignments.

AI-Enhanced​

Uses your configured AI provider to score candidate posts for relevance and generate natural-sounding anchor text. Produces higher quality cross-links but adds a small delay and uses your AI provider's API quota.

SyteOps supports six AI providers for cross-link scoring: OpenAI, Anthropic, OpenRouter (recommended), Gemini, Perplexity, and Straico. OpenRouter is recommended because it gives you access to models from all providers with a single API key.

Requirements:

  • At least one AI provider API key configured in the System / API tab
  • An AI provider and model selected for the Cross-Link AI area (open the AI Providers section in the LinkCentral card, or click Configure AI Provider in the card header)

If the AI provider is unavailable (API error, rate limit, missing key, etc.), the integration automatically falls back to heuristic mode.

Dry Run / Preview​

You can test the integration without saving changes to the post. This is useful for verifying your settings before going live.

Option 1: Use the preview endpoint. Send a POST request to:

https://yoursite.com/wp-json/syteops/v1/linkcentral/preview-links

with the same body as the main endpoint. This always returns proposed changes without modifying the post.

Option 2: Add "dry_run": true to your request body:

{"post_id": 12345, "dry_run": true}

Both options return the full response showing which links would be inserted, where they would go, and any warnings.

Troubleshooting​

"No keywords found in LinkCentral index" LinkCentral doesn't have any published links with keywords configured. Open LinkCentral and make sure your links have keywords assigned.

"LinkCentral integration is not enabled" (503 error) The LinkCentral toggle is off. Go to the Integrations tab, enable LinkCentral, and save.

"Unauthorized" or "Invalid token" (401 error) The API token in your FlowMattic step doesn't match the one saved in SyteOps settings. Copy the exact token from your SyteOps System / API tab into your FlowMattic Bearer Token field.

"API token not configured" (401 error) No API token has been saved in SyteOps yet. Go to the System / API tab, enter a token in the LinkCentral card, and save.

Links not appearing in the post

  • Verify the post is in draft, publish, pending, or future status
  • Verify the post has actual content (not empty)
  • Check the response from the endpoint — the total_links_inserted field tells you how many links were added. If zero, check the warnings array for details.
  • Make sure your LinkCentral keywords actually appear in the post content (for Exact match mode), or that your AI provider is configured if you use AI semantic match or Fallback

Elementor-built pages

Elementor stores your layout in Elementor’s own data, not in the regular WordPress content field. SyteOps reads the same rendered HTML a visitor would see when matching keywords and cross-links. If you run a live (non–dry-run) process, SyteOps may report proposed links in the response but not write them into the post automatically, and you will see a warning explaining that Elementor pages must be updated in Elementor (or use a block/classic post if you need automatic saving into the post body).

Cross-links not appearing

  • The post needs to have categories or tags assigned for the cross-linker to find related posts
  • There must be other published posts sharing those categories or tags
  • If using AI mode: verify your AI provider API key is valid and a model is selected for LinkCentral

REST API Reference​

All endpoints require Bearer token authentication. Use the API token you configured in the LinkCentral settings card.

Authorization: Bearer {your_api_token}
Content-Type: application/json

POST /wp-json/syteops/v1/linkcentral/process-links

Processes a post by inserting keyword links and cross-links.

Request body:

FieldTypeRequiredDescription
post_idintegerYesThe WordPress post ID to process.
dry_runbooleanNoWhen true, returns proposed changes without modifying the post. Default: false.
optionsobjectNoOverride default settings for this request (see Options below).

Options object (all fields optional — omit to use your saved settings):

FieldTypeDescription
max_lc_links_per_500_wordsintegerOverride max keyword links per 500 words.
max_crosslinksintegerOverride max cross-links per post.
crosslink_modestring"heuristic" or "ai".
first_occurrencebooleanOverride first-occurrence-only setting.
target_blankbooleanOverride open-in-new-tab setting.
keyword_matching_modestringexact, ai, or fallback — same meaning as the Keyword Matching Mode setting.

Example request:

{
  "post_id": 12345,
  "dry_run": false,
  "options": {
    "max_crosslinks": 5,
    "crosslink_mode": "ai"
  }
}

Success response (200):

{
  "ok": true,
  "post_id": 12345,
  "dry_run": false,
  "linkcentral_links_inserted": 5,
  "crosslinks_inserted": 2,
  "total_links_inserted": 7,
  "word_count": 1200,
  "links_per_500_words": 2.92,
  "crosslink_mode": "ai",
  "keyword_matching_mode": "exact",
  "details": {
    "linkcentral": [
      {"keyword": "project management", "url": "https://...", "position": "paragraph_2"}
    ],
    "crosslinks": [
      {"post_id": 456, "title": "Related Post", "anchor": "related topic", "url": "https://...", "position": "paragraph_4"}
    ]
  },
  "warnings": [],
  "processing_time_ms": 245
}

Error responses:

StatusCodeCause
400invalid_post_idMissing or invalid post_id.
401unauthorizedMissing or invalid Bearer token.
404post_not_foundPost does not exist.
503integration_disabledLinkCentral integration is not enabled.

POST /wp-json/syteops/v1/linkcentral/preview-links

Identical to Process Links but always runs in dry-run mode. The post is never modified.

Request body: Same as Process Links (the dry_run field is ignored — always treated as true).

Status​

GET /wp-json/syteops/v1/linkcentral/status

Returns integration health, keyword index status, and available configuration.

Response (200):

{
  "ok": true,
  "linkcentral_active": true,
  "keyword_count": 42,
  "index_last_built": "2026-03-30 14:22:00",
  "index_ttl_remaining_seconds": 3200,
  "integration_enabled": true,
  "crosslink_modes_available": ["heuristic", "ai"],
  "ai_provider": "openrouter",
  "ai_provider_configured": true,
  "settings": {
    "max_lc_links_per_500_words": 3,
    "max_crosslinks": 3,
    "first_occurrence_only": true,
    "default_crosslink_mode": "heuristic"
  }
}