instagram-campaign-scout

Instagram Campaign Scout

Use this skill to scout Instagram hashtag opportunities, branded mentions, UGC, and campaign spread from public content.

Apply shared rulebook and user-guidance rules from postplus-shared.

Task Shapes

Use this skill when the user wants to:

• monitor a branded hashtag,
• find UGC or creator posts tagging a brand,
• inspect campaign spread on Instagram,
• map related hashtags around a topic or campaign.

Collection Key Routing

Route to the matching hosted collection key by task shape:

• hashtag post collection,
• branded keyword, account, or topic discovery,
• post sampling from known URLs or accounts.

Discover the exact released collection keys and request shapes with postplus research schema --json. Use hosted collection outputs and the workflow below.

Default Workflow

1. Choose the campaign object: hashtag, target username, or brand keyword.
2. Compile a small hashtag, search, or post request.
3. Write the compiled collection input to a request file.
4. Collect hashtag, search, or post data.
5. Normalize outputs into comparable datasets.
6. Identify volume signals, related hashtags, top tagged creators, and UGC examples.
7. Build a watchlist when repeated monitoring is needed.

First-Pass Bounds

• 1-3 branded hashtags.
• 1-5 target usernames.
• A small tagged-post sample.
• No full social-listening crawl on the first pass.

Good Output

Return a branded hashtag opportunity map, top tagged or mentioning posts, likely creators driving visibility, related hashtag clusters, and a recommended watchlist of usernames, hashtags, and tagged mentions.

Failure Modes

• Stop if the request cannot be answered from public Instagram campaign surfaces.
• Stop on unsupported keys, missing auth, unavailable hosted service, or stable network failure.
• Do not inflate campaign spread from a small public sample; label the sample scope.

Handoff

• Tagged creators needing partnership evaluation -> instagram-account-research.
• Hashtag or tagged surfaces becoming a broader creator pool -> instagram-creator-discovery.
• Tagged posts needing deeper benchmark analysis -> instagram-content-benchmark.

Public Command Boundary

• Choose the smallest matching command or workflow from the user input and run it directly.
• Readiness diagnostics: postplus doctor --skill instagram-campaign-scout.
• If an owned CLI or script command fails, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback providers, or unpublished tools.
• Use postplus research schema --collection-key <collectionKey> --json only when constructing or repairing an unknown request shape.
• Hosted collection runs through the shared research collect verb (owned by instagram-tools), attributing the run to this skill: postplus research collect <collectionKey> --skill instagram-campaign-scout --request <input.json> --output <result.json> (input = the collection parameters).
• Resume a pending collection: postplus research collect --run-handle <runHandle> --output <result.json>.
• Keep the first pass bounded; expand only after inspecting the first result.
• If the CLI returns a quote-confirmation challenge, run postplus quote confirm --json --challenge-file <challenge.json> and retry with the returned token.