linkedin_ads_get_creative_analysis
Get LinkedIn Creative Analysis
LinkedinDescription
Break down one of your own LinkedIn creatives in one call: its creative profile (format, hook_type, hook_text, archetype, promise_type, visual_style, pacing in cuts per 10 s, has_voiceover, has_captions, has_person_on_screen, cta_text_on_screen, duration_s, aspect_ratio), the storyboard (8-section narrative), and for a video the transcript, audio analysis and audio track, plus frames as cdn.hopkin.ai URLs (2 fps; frame N sits at N / 2 s). At most 120 frame URLs per creative; pass stride or a start/end window in seconds to list others. Media is served by URL, never inline. Needs creative intelligence on the creative's ad account (linkedin_ads_enable_creative_intelligence). A creative that is not analyzed is not an error: status says why — not_enrolled (no analysis linked on this connection: enable the ad account, or the creative has not spent in the lookback window yet), processing (linked, analysis still running), no_source (nothing to analyze: LinkedIn refuses access to thought-leader posts written by a member, the creative has no media such as a conversation ad, or it is a document ad, which is not analyzed yet), failed (the media could not be mirrored or its frames extracted) — and message says what to do. To compare creatives across the ad account (which hooks win), use linkedin_ads_get_performance_report with group_by instead.
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "linkedin_ads_get_creative_analysis",
"arguments": {}
}
}
hopkin linkedin creative-analysis get
| Flag | Type | Required | Description |
|---|---|---|---|
--creative-id | string | Required | The LinkedIn creative to break down, e.g. "123456789" (from linkedin_ads_list_creatives or a performance report row). |
--stride | integer | Optional | List every Nth extracted frame. Defaults to a stride that fits each video into its share of 120 frame URLs per creative (split evenly between the creative's videos). |
--start | number | Optional | Only frames at or after this offset into the video, in seconds |
--end | number | Optional | Only frames at or before this offset into the video, in seconds |
--connection-id | string | Optional | Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs. |
{
"mcpServers": {
"linkedin-ads": {
"url": "https://linkedin.mcp.hopkin.ai",
"transport": "sse"
}
}
}
No example prompts available.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
creative_id |
string |
Required | The LinkedIn creative to break down, e.g. "123456789" (from linkedin_ads_list_creatives or a performance report row).minLength: 1, maxLength: 64, pattern: ^(urn:li:sponsoredCreative:)?\d+$ |
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (4)
| Name | Type | Required | Description |
|---|---|---|---|
stride |
integer |
Optional | List every Nth extracted frame. Defaults to a stride that fits each video into its share of 120 frame URLs per creative (split evenly between the creative's videos).min: 1 |
start |
number |
Optional | Only frames at or after this offset into the video, in secondsmin: 0 |
end |
number |
Optional | Only frames at or before this offset into the video, in secondsmin: 0 |
connection_id |
string |
Optional | Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs. |