@cesteral/linkedin-mcp 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +201 -0
- package/README.md +304 -0
- package/dist/auth/index.d.ts +3 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +3 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/linkedin-auth-adapter.d.ts +38 -0
- package/dist/auth/linkedin-auth-adapter.d.ts.map +1 -0
- package/dist/auth/linkedin-auth-adapter.js +110 -0
- package/dist/auth/linkedin-auth-adapter.js.map +1 -0
- package/dist/auth/linkedin-auth-strategy.d.ts +14 -0
- package/dist/auth/linkedin-auth-strategy.d.ts.map +1 -0
- package/dist/auth/linkedin-auth-strategy.js +50 -0
- package/dist/auth/linkedin-auth-strategy.js.map +1 -0
- package/dist/config/index.d.ts +100 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +37 -0
- package/dist/config/index.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +40 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.js +108 -0
- package/dist/mcp-server/prompts/definitions/analytics-reporting-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js +177 -0
- package/dist/mcp-server/prompts/definitions/bulk-operations-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js +171 -0
- package/dist/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js +109 -0
- package/dist/mcp-server/prompts/definitions/creative-upload-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js +299 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js +170 -0
- package/dist/mcp-server/prompts/definitions/cross-platform-performance.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js +213 -0
- package/dist/mcp-server/prompts/definitions/entity-duplication-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js +151 -0
- package/dist/mcp-server/prompts/definitions/entity-update-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js +217 -0
- package/dist/mcp-server/prompts/definitions/targeting-discovery-workflow.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js +98 -0
- package/dist/mcp-server/prompts/definitions/tool-schema-exploration.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts +4 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.d.ts.map +1 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js +91 -0
- package/dist/mcp-server/prompts/definitions/troubleshoot-entity.prompt.js.map +1 -0
- package/dist/mcp-server/prompts/index.d.ts +9 -0
- package/dist/mcp-server/prompts/index.d.ts.map +1 -0
- package/dist/mcp-server/prompts/index.js +97 -0
- package/dist/mcp-server/prompts/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/analytics-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/analytics-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/analytics-reference.resource.js +162 -0
- package/dist/mcp-server/resources/definitions/analytics-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js +164 -0
- package/dist/mcp-server/resources/definitions/entity-examples.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js +144 -0
- package/dist/mcp-server/resources/definitions/entity-hierarchy.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts +4 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js +127 -0
- package/dist/mcp-server/resources/definitions/entity-schemas.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +8 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +54 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts +3 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js +122 -0
- package/dist/mcp-server/resources/definitions/targeting-reference.resource.js.map +1 -0
- package/dist/mcp-server/resources/index.d.ts +3 -0
- package/dist/mcp-server/resources/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/index.js +2 -0
- package/dist/mcp-server/resources/index.js.map +1 -0
- package/dist/mcp-server/resources/types.d.ts +8 -0
- package/dist/mcp-server/resources/types.d.ts.map +1 -0
- package/dist/mcp-server/resources/types.js +2 -0
- package/dist/mcp-server/resources/types.js.map +1 -0
- package/dist/mcp-server/server.d.ts +5 -0
- package/dist/mcp-server/server.d.ts.map +1 -0
- package/dist/mcp-server/server.js +128 -0
- package/dist/mcp-server/server.js.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts +213 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js +174 -0
- package/dist/mcp-server/tools/definitions/adjust-bids.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts +128 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js +95 -0
- package/dist/mcp-server/tools/definitions/bulk-create-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts +183 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js +122 -0
- package/dist/mcp-server/tools/definitions/bulk-update-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts +140 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js +109 -0
- package/dist/mcp-server/tools/definitions/bulk-update-status.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts +117 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js +98 -0
- package/dist/mcp-server/tools/definitions/create-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts +93 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js +100 -0
- package/dist/mcp-server/tools/definitions/delete-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts +95 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js +89 -0
- package/dist/mcp-server/tools/definitions/duplicate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts +75 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js +68 -0
- package/dist/mcp-server/tools/definitions/get-ad-preview.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts +75 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js +71 -0
- package/dist/mcp-server/tools/definitions/get-ad-previews.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.d.ts +223 -0
- package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.js +152 -0
- package/dist/mcp-server/tools/definitions/get-analytics-breakdowns.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-analytics.tool.d.ts +325 -0
- package/dist/mcp-server/tools/definitions/get-analytics.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-analytics.tool.js +154 -0
- package/dist/mcp-server/tools/definitions/get-analytics.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.d.ts +95 -0
- package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.js +90 -0
- package/dist/mcp-server/tools/definitions/get-delivery-forecast.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts +75 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js +75 -0
- package/dist/mcp-server/tools/definitions/get-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts +81 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js +76 -0
- package/dist/mcp-server/tools/definitions/get-targeting-options.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +23 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +69 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts +141 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js +84 -0
- package/dist/mcp-server/tools/definitions/list-ad-accounts.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts +165 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js +112 -0
- package/dist/mcp-server/tools/definitions/list-entities.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts +102 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js +98 -0
- package/dist/mcp-server/tools/definitions/search-targeting.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts +104 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js +88 -0
- package/dist/mcp-server/tools/definitions/update-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts +75 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js +99 -0
- package/dist/mcp-server/tools/definitions/upload-image.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts +69 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js +98 -0
- package/dist/mcp-server/tools/definitions/upload-video.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts +168 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js +200 -0
- package/dist/mcp-server/tools/definitions/validate-entity.tool.js.map +1 -0
- package/dist/mcp-server/tools/index.d.ts +2 -0
- package/dist/mcp-server/tools/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/index.js +2 -0
- package/dist/mcp-server/tools/index.js.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts +13 -0
- package/dist/mcp-server/tools/utils/entity-mapping.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js +68 -0
- package/dist/mcp-server/tools/utils/entity-mapping.js.map +1 -0
- package/dist/mcp-server/tools/utils/media-types.d.ts +12 -0
- package/dist/mcp-server/tools/utils/media-types.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/media-types.js +2 -0
- package/dist/mcp-server/tools/utils/media-types.js.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts +4 -0
- package/dist/mcp-server/tools/utils/resolve-session.d.ts.map +1 -0
- package/dist/mcp-server/tools/utils/resolve-session.js +6 -0
- package/dist/mcp-server/tools/utils/resolve-session.js.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts +49 -0
- package/dist/mcp-server/transports/streamable-http-transport.d.ts.map +1 -0
- package/dist/mcp-server/transports/streamable-http-transport.js +91 -0
- package/dist/mcp-server/transports/streamable-http-transport.js.map +1 -0
- package/dist/services/linkedin/linkedin-http-client.d.ts +20 -0
- package/dist/services/linkedin/linkedin-http-client.d.ts.map +1 -0
- package/dist/services/linkedin/linkedin-http-client.js +147 -0
- package/dist/services/linkedin/linkedin-http-client.js.map +1 -0
- package/dist/services/linkedin/linkedin-reporting-service.d.ts +26 -0
- package/dist/services/linkedin/linkedin-reporting-service.d.ts.map +1 -0
- package/dist/services/linkedin/linkedin-reporting-service.js +69 -0
- package/dist/services/linkedin/linkedin-reporting-service.js.map +1 -0
- package/dist/services/linkedin/linkedin-service.d.ts +84 -0
- package/dist/services/linkedin/linkedin-service.d.ts.map +1 -0
- package/dist/services/linkedin/linkedin-service.js +195 -0
- package/dist/services/linkedin/linkedin-service.js.map +1 -0
- package/dist/services/linkedin/types.d.ts +166 -0
- package/dist/services/linkedin/types.d.ts.map +1 -0
- package/dist/services/linkedin/types.js +31 -0
- package/dist/services/linkedin/types.js.map +1 -0
- package/dist/services/session-services.d.ts +18 -0
- package/dist/services/session-services.d.ts.map +1 -0
- package/dist/services/session-services.js +16 -0
- package/dist/services/session-services.js.map +1 -0
- package/dist/types-global/mcp.d.ts +2 -0
- package/dist/types-global/mcp.d.ts.map +1 -0
- package/dist/types-global/mcp.js +2 -0
- package/dist/types-global/mcp.js.map +1 -0
- package/dist/utils/errors/index.d.ts +2 -0
- package/dist/utils/errors/index.d.ts.map +1 -0
- package/dist/utils/errors/index.js +2 -0
- package/dist/utils/errors/index.js.map +1 -0
- package/dist/utils/platform.d.ts +3 -0
- package/dist/utils/platform.d.ts.map +1 -0
- package/dist/utils/platform.js +5 -0
- package/dist/utils/platform.js.map +1 -0
- package/dist/utils/security/rate-limiter.d.ts +3 -0
- package/dist/utils/security/rate-limiter.d.ts.map +1 -0
- package/dist/utils/security/rate-limiter.js +5 -0
- package/dist/utils/security/rate-limiter.js.map +1 -0
- package/dist/utils/telemetry/index.d.ts +2 -0
- package/dist/utils/telemetry/index.d.ts.map +1 -0
- package/dist/utils/telemetry/index.js +2 -0
- package/dist/utils/telemetry/index.js.map +1 -0
- package/dist/utils/telemetry/tracing.d.ts +3 -0
- package/dist/utils/telemetry/tracing.d.ts.map +1 -0
- package/dist/utils/telemetry/tracing.js +4 -0
- package/dist/utils/telemetry/tracing.js.map +1 -0
- package/package.json +55 -0
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
export const linkedInCampaignSetupWorkflowPrompt = {
|
|
2
|
+
name: "linkedin_campaign_setup_workflow",
|
|
3
|
+
description: "Step-by-step guide for creating a complete LinkedIn Ads campaign structure (Campaign Group > Campaign > Creative)",
|
|
4
|
+
arguments: [
|
|
5
|
+
{
|
|
6
|
+
name: "adAccountUrn",
|
|
7
|
+
description: "LinkedIn Ad Account URN (e.g., urn:li:sponsoredAccount:123456789)",
|
|
8
|
+
required: true,
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
name: "includeTargeting",
|
|
12
|
+
description: "Whether to include targeting setup steps (true/false)",
|
|
13
|
+
required: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
};
|
|
17
|
+
export function getLinkedInCampaignSetupWorkflowMessage(args) {
|
|
18
|
+
const adAccountUrn = args?.adAccountUrn || "{adAccountUrn}";
|
|
19
|
+
const includeTargeting = args?.includeTargeting !== "false";
|
|
20
|
+
return `# LinkedIn Campaign Setup Workflow
|
|
21
|
+
|
|
22
|
+
## Prerequisites
|
|
23
|
+
- Ad Account URN: \`${adAccountUrn}\`
|
|
24
|
+
- Verify account access: \`linkedin_list_ad_accounts\`
|
|
25
|
+
- Check entity hierarchy: fetch resource \`entity-hierarchy://linkedin/all\`
|
|
26
|
+
|
|
27
|
+
## Step 1: Create Campaign Group
|
|
28
|
+
|
|
29
|
+
Campaign groups organize related campaigns and can share a budget cap.
|
|
30
|
+
|
|
31
|
+
\`\`\`json
|
|
32
|
+
linkedin_create_entity({
|
|
33
|
+
"entityType": "campaignGroup",
|
|
34
|
+
"data": {
|
|
35
|
+
"name": "Q2 2026 Brand Campaign",
|
|
36
|
+
"account": "${adAccountUrn}",
|
|
37
|
+
"status": "DRAFT",
|
|
38
|
+
"totalBudget": { "amount": "10000.00", "currencyCode": "USD" },
|
|
39
|
+
"runSchedule": {
|
|
40
|
+
"start": 1746057600000,
|
|
41
|
+
"end": 1753833600000
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
})
|
|
45
|
+
\`\`\`
|
|
46
|
+
|
|
47
|
+
**Save the returned campaign group URN:** \`urn:li:sponsoredCampaignGroup:XXXXXXXXX\`
|
|
48
|
+
|
|
49
|
+
## Step 2: Create Campaign
|
|
50
|
+
|
|
51
|
+
\`\`\`json
|
|
52
|
+
linkedin_create_entity({
|
|
53
|
+
"entityType": "campaign",
|
|
54
|
+
"data": {
|
|
55
|
+
"name": "Brand Awareness - Tech Leaders",
|
|
56
|
+
"campaignGroup": "urn:li:sponsoredCampaignGroup:XXXXXXXXX",
|
|
57
|
+
"account": "${adAccountUrn}",
|
|
58
|
+
"type": "SPONSORED_UPDATES",
|
|
59
|
+
"objectiveType": "BRAND_AWARENESS",
|
|
60
|
+
"status": "DRAFT",
|
|
61
|
+
"dailyBudget": { "amount": "100.00", "currencyCode": "USD" },
|
|
62
|
+
"bidType": "CPM",
|
|
63
|
+
"unitCost": { "amount": "12.00", "currencyCode": "USD" },
|
|
64
|
+
"locale": { "country": "US", "language": "en" }
|
|
65
|
+
}
|
|
66
|
+
})
|
|
67
|
+
\`\`\`
|
|
68
|
+
|
|
69
|
+
**Campaign Types:** SPONSORED_UPDATES, TEXT_AD, DYNAMIC, VIDEO, CAROUSEL
|
|
70
|
+
|
|
71
|
+
**Objective Types:** BRAND_AWARENESS, WEBSITE_TRAFFIC, WEBSITE_CONVERSIONS,
|
|
72
|
+
LEAD_GENERATION, ENGAGEMENT, VIDEO_VIEWS
|
|
73
|
+
${includeTargeting
|
|
74
|
+
? `
|
|
75
|
+
## Step 3: Add Targeting
|
|
76
|
+
|
|
77
|
+
Add targeting criteria to the campaign via update:
|
|
78
|
+
|
|
79
|
+
\`\`\`json
|
|
80
|
+
linkedin_update_entity({
|
|
81
|
+
"entityType": "campaign",
|
|
82
|
+
"entityUrn": "urn:li:sponsoredCampaign:XXXXXXXXX",
|
|
83
|
+
"data": {
|
|
84
|
+
"targetingCriteria": {
|
|
85
|
+
"include": {
|
|
86
|
+
"and": [
|
|
87
|
+
{
|
|
88
|
+
"or": {
|
|
89
|
+
"urn:li:adTargetingFacet:geos": ["urn:li:geo:103644278"]
|
|
90
|
+
}
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
"or": {
|
|
94
|
+
"urn:li:adTargetingFacet:memberSeniorities": [
|
|
95
|
+
"urn:li:adSeniority:5",
|
|
96
|
+
"urn:li:adSeniority:6"
|
|
97
|
+
]
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
]
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
})
|
|
105
|
+
\`\`\`
|
|
106
|
+
|
|
107
|
+
To find targeting URNs, use: \`linkedin_search_targeting({ facetType: "MEMBER_SENIORITY" })\`
|
|
108
|
+
|
|
109
|
+
**Get audience size forecast:**
|
|
110
|
+
\`\`\`json
|
|
111
|
+
linkedin_get_delivery_forecast({
|
|
112
|
+
"adAccountUrn": "${adAccountUrn}",
|
|
113
|
+
"targetingCriteria": { ... }
|
|
114
|
+
})
|
|
115
|
+
\`\`\`
|
|
116
|
+
`
|
|
117
|
+
: ""}
|
|
118
|
+
## Step 4: Create Creative
|
|
119
|
+
|
|
120
|
+
Creative links your content (UGC post, share, etc.) to the campaign.
|
|
121
|
+
|
|
122
|
+
\`\`\`json
|
|
123
|
+
linkedin_create_entity({
|
|
124
|
+
"entityType": "creative",
|
|
125
|
+
"data": {
|
|
126
|
+
"campaign": "urn:li:sponsoredCampaign:XXXXXXXXX",
|
|
127
|
+
"status": "DRAFT",
|
|
128
|
+
"reference": "urn:li:ugcPost:YOUR_UGC_POST_ID"
|
|
129
|
+
}
|
|
130
|
+
})
|
|
131
|
+
\`\`\`
|
|
132
|
+
|
|
133
|
+
**Reference formats:**
|
|
134
|
+
- Organic post: \`urn:li:ugcPost:{postId}\`
|
|
135
|
+
- Share: \`urn:li:share:{shareId}\`
|
|
136
|
+
|
|
137
|
+
## Step 5: Verify & Activate
|
|
138
|
+
|
|
139
|
+
1. Validate payloads: \`linkedin_validate_entity\`
|
|
140
|
+
2. Preview creative: \`linkedin_get_ad_preview({ creativeUrn: "..." })\`
|
|
141
|
+
3. Review all entities:
|
|
142
|
+
- Campaign group: \`linkedin_get_entity({ entityType: "campaignGroup", entityUrn: "..." })\`
|
|
143
|
+
- Campaign: \`linkedin_get_entity({ entityType: "campaign", entityUrn: "..." })\`
|
|
144
|
+
- Creative: \`linkedin_get_entity({ entityType: "creative", entityUrn: "..." })\`
|
|
145
|
+
4. Activate: \`linkedin_bulk_update_status\` to set ACTIVE
|
|
146
|
+
|
|
147
|
+
## Common Gotchas
|
|
148
|
+
|
|
149
|
+
| Issue | Solution |
|
|
150
|
+
|-------|----------|
|
|
151
|
+
| Budget in wrong format | Use CurrencyAmount: \`{ "amount": "100.00", "currencyCode": "USD" }\` |
|
|
152
|
+
| Invalid URN format | All IDs must start with \`urn:li:\` |
|
|
153
|
+
| Campaign not serving | Check campaign status is ACTIVE, not DRAFT |
|
|
154
|
+
| Creative review pending | Allow 24-48h for LinkedIn creative review |
|
|
155
|
+
| Missing targeting | Campaigns without targeting may have limited delivery |
|
|
156
|
+
|
|
157
|
+
## Analytics After Launch
|
|
158
|
+
|
|
159
|
+
\`\`\`json
|
|
160
|
+
linkedin_get_analytics({
|
|
161
|
+
"adAccountUrn": "${adAccountUrn}",
|
|
162
|
+
"startDate": "2026-03-01",
|
|
163
|
+
"endDate": "2026-03-31",
|
|
164
|
+
"metrics": ["impressions", "clicks", "costInUsd", "conversions"],
|
|
165
|
+
"pivot": "CAMPAIGN",
|
|
166
|
+
"timeGranularity": "DAILY"
|
|
167
|
+
})
|
|
168
|
+
\`\`\`
|
|
169
|
+
`;
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=campaign-setup-workflow.prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"campaign-setup-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-setup-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,mCAAmC,GAAW;IACzD,IAAI,EAAE,kCAAkC;IACxC,WAAW,EACT,mHAAmH;IACrH,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,mEAAmE;YAChF,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,uDAAuD;YACpE,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,uCAAuC,CAAC,IAA6B;IACnF,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAC5D,MAAM,gBAAgB,GAAG,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC;IAE5D,OAAO;;;sBAGa,YAAY;;;;;;;;;;;;;kBAahB,YAAY;;;;;;;;;;;;;;;;;;;;;kBAqBZ,YAAY;;;;;;;;;;;;;;;;EAiB5B,gBAAgB;QACd,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsCe,YAAY;;;;CAIhC;QACG,CAAC,CAAC,EACN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4CqB,YAAY;;;;;;;;CAQhC,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
+
export declare const linkedInCreativeUploadWorkflowPrompt: Prompt;
|
|
3
|
+
export declare function getLinkedInCreativeUploadWorkflowMessage(args?: Record<string, string>): string;
|
|
4
|
+
//# sourceMappingURL=creative-upload-workflow.prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creative-upload-workflow.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,eAAO,MAAM,oCAAoC,EAAE,MAWlD,CAAC;AAEF,wBAAgB,wCAAwC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAiG9F"}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
export const linkedInCreativeUploadWorkflowPrompt = {
|
|
2
|
+
name: "creative_upload_workflow",
|
|
3
|
+
description: "Step-by-step guide for uploading images and creating LinkedIn Sponsored Content creatives",
|
|
4
|
+
arguments: [
|
|
5
|
+
{
|
|
6
|
+
name: "adAccountUrn",
|
|
7
|
+
description: "LinkedIn Ad Account URN (e.g., urn:li:sponsoredAccount:123456)",
|
|
8
|
+
required: true,
|
|
9
|
+
},
|
|
10
|
+
],
|
|
11
|
+
};
|
|
12
|
+
export function getLinkedInCreativeUploadWorkflowMessage(args) {
|
|
13
|
+
const adAccountUrn = args?.adAccountUrn || "{adAccountUrn}";
|
|
14
|
+
return `# LinkedIn Ads Creative Upload Workflow
|
|
15
|
+
|
|
16
|
+
## Prerequisites
|
|
17
|
+
- Ad Account URN: \`${adAccountUrn}\`
|
|
18
|
+
- Organization URN for your company page (e.g., urn:li:organization:123456)
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
LinkedIn creative workflow: Upload image → Create Creative → Link to Campaign
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Step 1: Upload Image
|
|
26
|
+
|
|
27
|
+
\`\`\`json
|
|
28
|
+
linkedin_upload_image({
|
|
29
|
+
"adAccountUrn": "${adAccountUrn}",
|
|
30
|
+
"mediaUrl": "https://example.com/your-banner.jpg"
|
|
31
|
+
})
|
|
32
|
+
\`\`\`
|
|
33
|
+
|
|
34
|
+
**Returns:** \`assetUrn\` (format: urn:li:digitalmediaAsset:...)
|
|
35
|
+
|
|
36
|
+
⚠️ **GOTCHA**: LinkedIn processes assets asynchronously. The assetUrn is returned immediately but may take 1-5 minutes to be fully available for creative creation. If creative creation fails with "ASSET_NOT_READY", wait and retry.
|
|
37
|
+
|
|
38
|
+
**Image requirements:**
|
|
39
|
+
- Formats: JPEG, PNG, GIF
|
|
40
|
+
- Min 400x400px; recommended 1200x627px (1.91:1 ratio)
|
|
41
|
+
- Max 5MB
|
|
42
|
+
- Aspect ratios accepted: 1.91:1 (horizontal), 1:1 (square), 2:3 (vertical)
|
|
43
|
+
|
|
44
|
+
## Step 2: Create Creative
|
|
45
|
+
|
|
46
|
+
\`\`\`json
|
|
47
|
+
linkedin_create_entity({
|
|
48
|
+
"entityType": "creative",
|
|
49
|
+
"data": {
|
|
50
|
+
"account": "${adAccountUrn}",
|
|
51
|
+
"campaign": "{your_campaign_urn}",
|
|
52
|
+
"content": {
|
|
53
|
+
"contentType": "SPONSORED_IMAGE",
|
|
54
|
+
"media": {
|
|
55
|
+
"id": "{assetUrn_from_step_1}",
|
|
56
|
+
"headline": "Your Headline Here",
|
|
57
|
+
"description": "Your ad description",
|
|
58
|
+
"callToAction": "LEARN_MORE",
|
|
59
|
+
"landingPage": "https://yoursite.com"
|
|
60
|
+
}
|
|
61
|
+
},
|
|
62
|
+
"status": "DRAFT",
|
|
63
|
+
"type": "SPONSORED"
|
|
64
|
+
}
|
|
65
|
+
})
|
|
66
|
+
\`\`\`
|
|
67
|
+
|
|
68
|
+
⚠️ **GOTCHA**: Creative must be created in DRAFT status. Move to ACTIVE only after review.
|
|
69
|
+
|
|
70
|
+
## Step 3: Preview Creative
|
|
71
|
+
|
|
72
|
+
\`\`\`json
|
|
73
|
+
linkedin_get_ad_preview({
|
|
74
|
+
"creativeUrn": "{creativeUrn_from_step_2}",
|
|
75
|
+
"adFormat": "SPONSORED_IMAGE"
|
|
76
|
+
})
|
|
77
|
+
\`\`\`
|
|
78
|
+
|
|
79
|
+
## Step 4: Activate Creative
|
|
80
|
+
|
|
81
|
+
\`\`\`json
|
|
82
|
+
linkedin_update_entity({
|
|
83
|
+
"entityType": "creative",
|
|
84
|
+
"entityUrn": "{creativeUrn}",
|
|
85
|
+
"data": { "status": "ACTIVE" }
|
|
86
|
+
})
|
|
87
|
+
\`\`\`
|
|
88
|
+
|
|
89
|
+
## Common Errors
|
|
90
|
+
|
|
91
|
+
| Error | Cause | Fix |
|
|
92
|
+
|-------|-------|-----|
|
|
93
|
+
| "ASSET_NOT_READY" | Asset still processing | Wait 1-5 min, retry |
|
|
94
|
+
| "INVALID_ASPECT_RATIO" | Wrong image ratio | Use 1.91:1, 1:1, or 2:3 |
|
|
95
|
+
| "MISSING_ORGANIZATION" | No org page linked | Link organization to ad account |
|
|
96
|
+
| "CAMPAIGN_NOT_FOUND" | Wrong campaign URN | Verify using linkedin_list_entities |
|
|
97
|
+
|
|
98
|
+
## Common Call-to-Action Values
|
|
99
|
+
LEARN_MORE, SIGN_UP, REGISTER, JOIN_NOW, REQUEST_DEMO, TRY_FREE, CONTACT_US, GET_QUOTE, APPLY_NOW, DOWNLOAD
|
|
100
|
+
|
|
101
|
+
## Success Criteria
|
|
102
|
+
- [ ] Image uploaded (assetUrn obtained)
|
|
103
|
+
- [ ] Creative created in DRAFT status
|
|
104
|
+
- [ ] Preview reviewed
|
|
105
|
+
- [ ] Creative activated when ready
|
|
106
|
+
|
|
107
|
+
`;
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=creative-upload-workflow.prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creative-upload-workflow.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/creative-upload-workflow.prompt.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,oCAAoC,GAAW;IAC1D,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,2FAA2F;IAC7F,SAAS,EAAE;QACT;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,gEAAgE;YAC7E,QAAQ,EAAE,IAAI;SACf;KACF;CACF,CAAC;AAEF,MAAM,UAAU,wCAAwC,CAAC,IAA6B;IACpF,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,gBAAgB,CAAC;IAE5D,OAAO;;;sBAGa,YAAY;;;;;;;;;;;;qBAYb,YAAY;;;;;;;;;;;;;;;;;;;;;kBAqBf,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyD7B,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
+
export declare const crossPlatformCampaignSetupPrompt: Prompt;
|
|
3
|
+
export declare function getCrossPlatformCampaignSetupMessage(args?: Record<string, string>): string;
|
|
4
|
+
//# sourceMappingURL=cross-platform-campaign-setup.prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cross-platform-campaign-setup.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,gCAAgC,EAAE,MAiB9C,CAAC;AAEF,wBAAgB,oCAAoC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA0R1F"}
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
export const crossPlatformCampaignSetupPrompt = {
|
|
2
|
+
name: "cross_platform_campaign_setup",
|
|
3
|
+
description: "Guide for setting up a coordinated multi-platform campaign across DV360 (dv360-mcp), The Trade Desk (ttd-mcp), Google Ads (gads-mcp), Meta Ads (meta-mcp), LinkedIn (linkedin-mcp), TikTok (tiktok-mcp), Pinterest (pinterest-mcp), Snapchat (snapchat-mcp), and Amazon DSP (amazon-dsp-mcp). Covers platform selection, budget allocation, naming conventions, and phased launch.",
|
|
4
|
+
arguments: [
|
|
5
|
+
{
|
|
6
|
+
name: "totalBudget",
|
|
7
|
+
description: "Total campaign budget across all platforms (e.g., '50000' for $50,000)",
|
|
8
|
+
required: false,
|
|
9
|
+
},
|
|
10
|
+
{
|
|
11
|
+
name: "objective",
|
|
12
|
+
description: "Campaign objective: 'awareness', 'consideration', or 'conversion' (default: conversion)",
|
|
13
|
+
required: false,
|
|
14
|
+
},
|
|
15
|
+
],
|
|
16
|
+
};
|
|
17
|
+
export function getCrossPlatformCampaignSetupMessage(args) {
|
|
18
|
+
const totalBudget = args?.totalBudget || "{totalBudget}";
|
|
19
|
+
const objective = args?.objective || "conversion";
|
|
20
|
+
return `# Cross-Platform Coordinated Campaign Setup
|
|
21
|
+
|
|
22
|
+
Total Budget: \$${totalBudget}
|
|
23
|
+
Objective: \`${objective}\`
|
|
24
|
+
|
|
25
|
+
This workflow guides you through setting up campaigns across multiple ad platforms in a coordinated manner. You must be connected to the relevant MCP servers.
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## Step 1: Platform Selection
|
|
30
|
+
|
|
31
|
+
Choose platforms based on your objective and audience:
|
|
32
|
+
|
|
33
|
+
| Objective | Recommended Platforms | Rationale |
|
|
34
|
+
|-----------|----------------------|-----------|
|
|
35
|
+
| **Awareness** | DV360 + Meta + TikTok + Pinterest | DV360 for programmatic display/video reach, Meta/TikTok for social reach, Pinterest for visual discovery |
|
|
36
|
+
| **Consideration** | DV360 + TTD + Meta + LinkedIn | Broad programmatic reach with social engagement and B2B professional targeting |
|
|
37
|
+
| **Conversion** | Google Ads + Meta + TTD + Amazon DSP | Search intent (Google) + social retargeting (Meta) + programmatic (TTD) + retail intent (Amazon) |
|
|
38
|
+
| **B2B** | LinkedIn + Google Ads + Meta | Professional audience targeting on LinkedIn, search intent, social retargeting |
|
|
39
|
+
| **Gen Z / Video** | TikTok + Snapchat + Meta | Short-form video engagement across Gen Z/Millennial audiences |
|
|
40
|
+
| **Shopping / E-commerce** | Pinterest + Meta + Google Ads + Amazon DSP | Visual discovery + social + search + retail intent |
|
|
41
|
+
| **Full-Funnel** | All 9 platforms | Maximum reach across all touchpoints |
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Step 2: Budget Allocation
|
|
46
|
+
|
|
47
|
+
Split the total budget across platforms. Common allocation strategies:
|
|
48
|
+
|
|
49
|
+
### Performance-Based (Recommended for existing campaigns)
|
|
50
|
+
Allocate based on historical CPA/ROAS data. Use the \`cross_platform_performance_comparison\` prompt to gather data first.
|
|
51
|
+
|
|
52
|
+
### Equal Split (New campaigns with no history)
|
|
53
|
+
|
|
54
|
+
| Platform | Allocation | Budget |
|
|
55
|
+
|----------|-----------|--------|
|
|
56
|
+
| DV360 | 15% | \$${totalBudget} × 0.15 |
|
|
57
|
+
| TTD | 15% | \$${totalBudget} × 0.15 |
|
|
58
|
+
| Google Ads | 15% | \$${totalBudget} × 0.15 |
|
|
59
|
+
| Meta | 15% | \$${totalBudget} × 0.15 |
|
|
60
|
+
| LinkedIn | 10% | \$${totalBudget} × 0.10 |
|
|
61
|
+
| TikTok | 10% | \$${totalBudget} × 0.10 |
|
|
62
|
+
| Pinterest | 10% | \$${totalBudget} × 0.10 |
|
|
63
|
+
| Snapchat | 5% | \$${totalBudget} × 0.05 |
|
|
64
|
+
| Amazon DSP | 5% | \$${totalBudget} × 0.05 |
|
|
65
|
+
|
|
66
|
+
### Objective-Weighted
|
|
67
|
+
|
|
68
|
+
| Platform | Awareness | Consideration | Conversion | B2B | Shopping |
|
|
69
|
+
|----------|-----------|---------------|------------|-----|----------|
|
|
70
|
+
| DV360 | 25% | 20% | 10% | 5% | 5% |
|
|
71
|
+
| TTD | 15% | 15% | 15% | 5% | 10% |
|
|
72
|
+
| Google Ads | 5% | 15% | 30% | 20% | 20% |
|
|
73
|
+
| Meta | 20% | 20% | 15% | 15% | 20% |
|
|
74
|
+
| LinkedIn | 5% | 10% | 5% | 35% | 2% |
|
|
75
|
+
| TikTok | 15% | 10% | 10% | 5% | 8% |
|
|
76
|
+
| Pinterest | 10% | 5% | 5% | 0% | 20% |
|
|
77
|
+
| Snapchat | 5% | 5% | 5% | 0% | 5% |
|
|
78
|
+
| Amazon DSP | 0% | 0% | 5% | 15% | 10% |
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## Step 3: Naming Convention
|
|
83
|
+
|
|
84
|
+
Use consistent naming across all platforms for easy cross-platform tracking:
|
|
85
|
+
|
|
86
|
+
**Pattern:** \`{Brand}_{Objective}_{Platform}_{Geo}_{Audience}_{YYYYMM}\`
|
|
87
|
+
|
|
88
|
+
**Examples:**
|
|
89
|
+
- \`Acme_Conv_DV360_US_Retargeting_202603\`
|
|
90
|
+
- \`Acme_Conv_TTD_US_Retargeting_202603\`
|
|
91
|
+
- \`Acme_Conv_GADS_US_Search_202603\`
|
|
92
|
+
- \`Acme_Conv_META_US_Lookalike_202603\`
|
|
93
|
+
- \`Acme_B2B_LI_US_Professionals_202603\`
|
|
94
|
+
- \`Acme_Aware_TT_US_GenZ_202603\`
|
|
95
|
+
- \`Acme_Shop_PIN_US_ShoppingIntent_202603\`
|
|
96
|
+
- \`Acme_Aware_SNAP_US_GenZ_202603\`
|
|
97
|
+
- \`Acme_Conv_AMZN_US_Retargeting_202603\`
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## Step 4: Create Campaigns on Each Platform
|
|
102
|
+
|
|
103
|
+
### DV360 (via dv360-mcp)
|
|
104
|
+
|
|
105
|
+
Use the \`full_campaign_setup_workflow\` prompt for detailed guidance.
|
|
106
|
+
|
|
107
|
+
Key steps:
|
|
108
|
+
1. Create Campaign (PAUSED status)
|
|
109
|
+
2. Create Insertion Order (DRAFT status)
|
|
110
|
+
3. Create Line Items (DRAFT status)
|
|
111
|
+
4. Assign targeting
|
|
112
|
+
5. Activate via \`entity_activation_workflow\`
|
|
113
|
+
|
|
114
|
+
⚠️ **DV360 budget values are in micros** (1,000,000 = $1.00)
|
|
115
|
+
|
|
116
|
+
### The Trade Desk (via ttd-mcp)
|
|
117
|
+
|
|
118
|
+
Use the \`ttd_campaign_setup_workflow\` prompt for detailed guidance.
|
|
119
|
+
|
|
120
|
+
Key steps:
|
|
121
|
+
1. Create Campaign
|
|
122
|
+
2. Create Ad Groups with RTBAttributes
|
|
123
|
+
3. Create Ads and link Creatives
|
|
124
|
+
4. Set availability to "Available"
|
|
125
|
+
|
|
126
|
+
⚠️ **TTD budget values are in dollars** ($100.00 = 100.00)
|
|
127
|
+
|
|
128
|
+
### Google Ads (via gads-mcp)
|
|
129
|
+
|
|
130
|
+
Use the \`gads_campaign_setup_workflow\` prompt for detailed guidance.
|
|
131
|
+
|
|
132
|
+
Key steps:
|
|
133
|
+
1. Create Campaign Budget
|
|
134
|
+
2. Create Campaign (PAUSED)
|
|
135
|
+
3. Create Ad Groups
|
|
136
|
+
4. Create Keywords (for Search)
|
|
137
|
+
5. Create Responsive Search Ads
|
|
138
|
+
6. Enable campaign
|
|
139
|
+
|
|
140
|
+
⚠️ **Google Ads budget values are in micros** (1,000,000 = $1.00)
|
|
141
|
+
|
|
142
|
+
### Meta Ads (via meta-mcp)
|
|
143
|
+
|
|
144
|
+
Use the \`meta_campaign_setup_workflow\` prompt for detailed guidance.
|
|
145
|
+
|
|
146
|
+
Key steps:
|
|
147
|
+
1. Create Campaign (PAUSED)
|
|
148
|
+
2. Create Ad Creative
|
|
149
|
+
3. Create Ad Sets with targeting
|
|
150
|
+
4. Create Ads
|
|
151
|
+
5. Activate
|
|
152
|
+
|
|
153
|
+
⚠️ **Meta budget values are in cents** (5000 = $50.00)
|
|
154
|
+
|
|
155
|
+
### LinkedIn Ads (via linkedin-mcp)
|
|
156
|
+
|
|
157
|
+
Use the \`linkedin_campaign_setup_workflow\` prompt for detailed guidance.
|
|
158
|
+
|
|
159
|
+
Key steps:
|
|
160
|
+
1. Create Campaign Group (ACTIVE or PAUSED)
|
|
161
|
+
2. Create Campaign with targeting criteria and CPM bid
|
|
162
|
+
3. Create Creative linked to the campaign
|
|
163
|
+
4. Activate via \`linkedin_bulk_update_status\`
|
|
164
|
+
|
|
165
|
+
⚠️ **LinkedIn budget values are in dollars** ($100.00 = 100.00)
|
|
166
|
+
|
|
167
|
+
Best for: B2B, professional audiences, job title/company/skill targeting
|
|
168
|
+
|
|
169
|
+
### TikTok Ads (via tiktok-mcp)
|
|
170
|
+
|
|
171
|
+
Use the \`tiktok_campaign_setup_workflow\` prompt for detailed guidance.
|
|
172
|
+
|
|
173
|
+
Key steps:
|
|
174
|
+
1. Create Campaign with objective and budget
|
|
175
|
+
2. Create Ad Group with targeting and schedule
|
|
176
|
+
3. Upload creatives via \`tiktok_upload_video\` or \`tiktok_upload_image\`
|
|
177
|
+
4. Create Ads referencing the creative
|
|
178
|
+
5. Enable via \`tiktok_bulk_update_status\`
|
|
179
|
+
|
|
180
|
+
⚠️ **TikTok budget values are in dollars** ($100.00 = 100.00)
|
|
181
|
+
|
|
182
|
+
Best for: Short-form video, Gen Z/Millennial audiences, entertainment and lifestyle brands
|
|
183
|
+
|
|
184
|
+
### Pinterest (via pinterest-mcp)
|
|
185
|
+
|
|
186
|
+
Use the \`pinterest_campaign_setup_workflow\` prompt for detailed guidance.
|
|
187
|
+
|
|
188
|
+
Key steps:
|
|
189
|
+
1. Create Campaign (ACTIVE or PAUSED)
|
|
190
|
+
2. Create Ad Groups with targeting_spec
|
|
191
|
+
3. Upload/identify Pinterest Pin to promote
|
|
192
|
+
4. Create Ads referencing the Pin by pin_id
|
|
193
|
+
5. Activate via \`pinterest_bulk_update_status\`
|
|
194
|
+
|
|
195
|
+
⚠️ **Pinterest budget values are in micro-currency** (50000000 = $50.00)
|
|
196
|
+
|
|
197
|
+
Best for: E-commerce, lifestyle, food/beauty brands — high visual discovery and shopping intent
|
|
198
|
+
|
|
199
|
+
### Snapchat (via snapchat-mcp)
|
|
200
|
+
|
|
201
|
+
Use the \`snapchat_campaign_setup_workflow\` prompt for detailed guidance.
|
|
202
|
+
|
|
203
|
+
Key steps:
|
|
204
|
+
1. Create Campaign with objective and budget
|
|
205
|
+
2. Create Ad Squad (Ad Group) with targeting and placement
|
|
206
|
+
3. Upload creative via \`snapchat_upload_media\`
|
|
207
|
+
4. Create Ads referencing the creative
|
|
208
|
+
5. Activate via \`snapchat_bulk_update_status\`
|
|
209
|
+
|
|
210
|
+
⚠️ **Snapchat budget values are in micro-currency** (1 = $0.000001, so $100.00 = 100000000)
|
|
211
|
+
|
|
212
|
+
Best for: Gen Z audiences, AR lenses, video/story formats
|
|
213
|
+
|
|
214
|
+
### Amazon DSP (via amazon-dsp-mcp)
|
|
215
|
+
|
|
216
|
+
Use the \`amazon_dsp_campaign_setup_workflow\` prompt for detailed guidance.
|
|
217
|
+
|
|
218
|
+
Key steps:
|
|
219
|
+
1. Create Order (equivalent to Campaign) with flight dates and budget
|
|
220
|
+
2. Create Line Item with targeting and bid
|
|
221
|
+
3. Create Creative and attach to Line Item
|
|
222
|
+
4. Activate Order
|
|
223
|
+
|
|
224
|
+
⚠️ **Amazon DSP budget values are in dollars** ($100.00 = 100.00)
|
|
225
|
+
|
|
226
|
+
Best for: Retail/commerce intent, first-party Amazon audience data, programmatic display
|
|
227
|
+
|
|
228
|
+
---
|
|
229
|
+
|
|
230
|
+
## Step 5: Budget Value Reference
|
|
231
|
+
|
|
232
|
+
Critical — each platform uses different units:
|
|
233
|
+
|
|
234
|
+
| Platform | Unit | $100.00 Budget | $5.00 Bid | Best For |
|
|
235
|
+
|----------|------|---------------|-----------|----------|
|
|
236
|
+
| **DV360** | Micros | 100000000 | 5000000 | Programmatic display/video |
|
|
237
|
+
| **TTD** | Dollars | 100.00 | 5.00 | Programmatic DSP |
|
|
238
|
+
| **Google Ads** | Micros | 100000000 | 5000000 | Search intent |
|
|
239
|
+
| **Meta** | Cents | 10000 | 500 | Social retargeting |
|
|
240
|
+
| **LinkedIn** | Dollars | 100.00 | 5.00 | B2B professional audiences |
|
|
241
|
+
| **TikTok** | Dollars | 100.00 | 5.00 | Short-form video, Gen Z |
|
|
242
|
+
| **Pinterest** | Micro-currency | 100000000 | 5000000 | Visual discovery, shopping |
|
|
243
|
+
| **Snapchat** | Micro-currency | 100000000 | 5000000 | Gen Z, AR/video |
|
|
244
|
+
| **Amazon DSP** | Dollars | 100.00 | 5.00 | Retail/commerce intent |
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
## Step 6: Phased Launch
|
|
249
|
+
|
|
250
|
+
Don't activate all platforms simultaneously. Launch in phases to monitor:
|
|
251
|
+
|
|
252
|
+
### Phase 1: Pilot (Week 1)
|
|
253
|
+
- Launch on **one platform** (e.g., Google Ads for conversion, Meta for awareness)
|
|
254
|
+
- Allocate 25% of total budget
|
|
255
|
+
- Establish baseline CPA/ROAS
|
|
256
|
+
|
|
257
|
+
### Phase 2: Expand (Week 2)
|
|
258
|
+
- Add **second platform** (e.g., Meta or TTD)
|
|
259
|
+
- Compare performance with Phase 1 baseline
|
|
260
|
+
- Adjust bids based on early results
|
|
261
|
+
|
|
262
|
+
### Phase 3: Full Launch (Week 3+)
|
|
263
|
+
- Activate remaining platforms
|
|
264
|
+
- Use \`cross_platform_performance_comparison\` prompt to monitor
|
|
265
|
+
- Reallocate budget based on performance data
|
|
266
|
+
|
|
267
|
+
---
|
|
268
|
+
|
|
269
|
+
## Step 7: Cross-Platform Tracking
|
|
270
|
+
|
|
271
|
+
Set up consistent conversion tracking across platforms:
|
|
272
|
+
|
|
273
|
+
1. **UTM parameters**: Use consistent UTM source/medium/campaign across all platforms
|
|
274
|
+
2. **Conversion pixels**: Ensure all platforms track the same conversion events
|
|
275
|
+
3. **Attribution window**: Note that each platform uses different attribution models — cross-platform CPA comparisons are directional
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## Post-Launch Monitoring
|
|
280
|
+
|
|
281
|
+
After all platforms are live:
|
|
282
|
+
|
|
283
|
+
1. **Daily**: Check pacing on each platform
|
|
284
|
+
2. **Weekly**: Run \`cross_platform_performance_comparison\` to compare metrics
|
|
285
|
+
3. **Bi-weekly**: Reallocate budget from underperformers to top performers
|
|
286
|
+
4. **Monthly**: Review overall campaign ROAS and adjust strategy
|
|
287
|
+
|
|
288
|
+
---
|
|
289
|
+
|
|
290
|
+
## Gotchas
|
|
291
|
+
|
|
292
|
+
- **Create campaigns PAUSED/DRAFT on all platforms first**, then activate in a controlled sequence
|
|
293
|
+
- **Budget units differ per platform** — double-check the conversion table above
|
|
294
|
+
- **Targeting alignment**: Try to match audiences across platforms as closely as possible for valid comparisons
|
|
295
|
+
- **Creative formats differ**: Each platform has different ad format requirements — plan creative assets accordingly
|
|
296
|
+
- **Time zones**: Campaigns on different platforms may use different timezone settings — align flight dates carefully
|
|
297
|
+
`;
|
|
298
|
+
}
|
|
299
|
+
//# sourceMappingURL=cross-platform-campaign-setup.prompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cross-platform-campaign-setup.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-campaign-setup.prompt.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,gCAAgC,GAAW;IACtD,IAAI,EAAE,+BAA+B;IACrC,WAAW,EACT,oXAAoX;IACtX,SAAS,EAAE;QACT;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,wEAAwE;YACrF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,yFAAyF;YAC3F,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oCAAoC,CAAC,IAA6B;IAChF,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,YAAY,CAAC;IAElD,OAAO;;kBAES,WAAW;eACd,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiCJ,WAAW;kBACb,WAAW;yBACJ,WAAW;mBACjB,WAAW;uBACP,WAAW;qBACb,WAAW;wBACR,WAAW;sBACb,WAAW;wBACT,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyOlC,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { Prompt } from "@modelcontextprotocol/sdk/types.js";
|
|
2
|
+
export declare const crossPlatformPerformancePrompt: Prompt;
|
|
3
|
+
export declare function getCrossPlatformPerformanceMessage(args?: Record<string, string>): string;
|
|
4
|
+
//# sourceMappingURL=cross-platform-performance.prompt.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cross-platform-performance.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/cross-platform-performance.prompt.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE,eAAO,MAAM,8BAA8B,EAAE,MAY5C,CAAC;AAEF,wBAAgB,kCAAkC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CA8JxF"}
|