Optimly Developer Documentation

Optimly MCP

Get Agent Content Gaps

In short

Read ranked paths that AI agents or crawlers tried to retrieve but could not successfully access, with observed outcomes, operators, purpose, identity confidence, capture fidelity, timestamps, closest existing paths, and representative evidence.

get_agent_content_gaps · Free · Authentication required

Read ranked paths that AI agents or crawlers tried to retrieve but could not successfully access, with observed outcomes, operators, purpose, identity confidence, capture fidelity, timestamps, closest existing paths, and representative evidence.

When to use

Use to find content or routing fixes for pages AI agents wanted but could not reach. Use evidence to recommend one fix; never claim causality.

Access

All plans with a connected Site Insights site

Parameters

ParameterTypeRequiredDescription
site_idstringYesConnected Site Insights site ID.
brand_iduuidYesAuthorized brand ID.
start_datestringYesInclusive local start date in YYYY-MM-DD.
end_datestringYesInclusive local end date in YYYY-MM-DD.
limitnumberNoMaximum ranked gaps to return. Default 25.

Example prompt

Which pages did AI agents try to fetch from our site and fail?