All skills
facebooktwitterplaceslinkedin Cross-Platform Power Plays

City Market-Entry Scan

Get a 360-degree read on one city before you expand — local chatter, trending hooks, competitor density, and hiring momentum in a single scan

Run this skill with your agent
1. Connect the MCP server
https://apidirect.io/mcp?token=YOUR_API_KEY
2. Then just say to your agent
Should I open a {niche} in {city}? Run a full market-entry scan.
In clients that support MCP prompts (Claude Desktop, Claude Code, Cursor) this skill appears as a prompt named city-market-entry-scan. Any agent can also call get_skill(skill_id="city-market-entry-scan") to pull these steps on demand.

What it does

Expanding into a new metro is guesswork until you layer four independent lenses: what locals post on Facebook, what's trending on Twitter, how saturated the map is with competitors, and whether rivals are staffing up there. Each lens resolves a different unknown.

Who it's for: Operators and franchise or expansion teams evaluating a new city

Inputs

Input Required Description Example
niche Yes Your business category boutique fitness studio
city Yes The target metro to evaluate Nashville, Tennessee, United States
woeid Yes Twitter WOEID for the metro, used to pull its local trends 2457170

How your agent runs it

  1. 1
    search_facebook_locations(query="{city}")

    Resolve the city to a numeric location_id so the Facebook post search is geo-scoped to that metro.

  2. 2
    search_facebook_posts(query="{niche}", location_id=<location_id>, get_sentiment=true)

    Read how locals actually talk about this category in-market — demand, complaints, and gaps surfaced by real residents.

  3. 3
    twitter_trends(woeid={woeid})

    Pull what's trending in the metro right now to spot local events, sentiment, and hooks to localize the launch.

  4. 4
    search_places(query="{niche} {city}", zoom=12, pages=10)

    Map competitor density and ratings to judge saturation and find under-served pockets of the city.

  5. 5
    search_linkedin_jobs(query="{niche} {city}", sort_by=most_recent, posted_ago=30d)

    Gauge whether rivals are staffing up locally; active job posts signal a growing, competitive market and reveal pay benchmarks.

Delivers: A four-lens market-entry brief for the city — local demand sentiment, trending hooks, competitor saturation, and hiring momentum — capped with a go / no-go recommendation.

Tools used

The full playbook

This is exactly what the MCP returns to your agent (via the city-market-entry-scan prompt or get_skill tool), with your inputs filled in.

SKILL: City Market-Entry Scan
Expanding into a new metro is guesswork until you layer four independent lenses: what locals post on Facebook, what's trending on Twitter, how saturated the map is with competitors, and whether rivals are staffing up there. Each lens resolves a different unknown.

You are running this skill on API Direct via its MCP tools. Execute the steps below yourself by calling the named tools in order — values in <angle brackets> come from a previous step. Then deliver the result described at the end.

INPUTS:
  - niche (required): <niche — ASK THE USER>
  - city (required): <city — ASK THE USER>
  - woeid (required): <woeid — ASK THE USER>

STEPS:
  1. Tool `search_facebook_locations` — search_facebook_locations(query="<city>")
     Resolve the city to a numeric location_id so the Facebook post search is geo-scoped to that metro.
  2. Tool `search_facebook_posts` — search_facebook_posts(query="<niche>", location_id=<location_id>, get_sentiment=true)
     Read how locals actually talk about this category in-market — demand, complaints, and gaps surfaced by real residents.
  3. Tool `twitter_trends` — twitter_trends(woeid=<woeid>)
     Pull what's trending in the metro right now to spot local events, sentiment, and hooks to localize the launch.
  4. Tool `search_places` — search_places(query="<niche> <city>", zoom=12, pages=10)
     Map competitor density and ratings to judge saturation and find under-served pockets of the city.
  5. Tool `search_linkedin_jobs` — search_linkedin_jobs(query="<niche> <city>", sort_by=most_recent, posted_ago=30d)
     Gauge whether rivals are staffing up locally; active job posts signal a growing, competitive market and reveal pay benchmarks.

DELIVER: A four-lens market-entry brief for the city — local demand sentiment, trending hooks, competitor saturation, and hiring momentum — capped with a go / no-go recommendation.

Note: each underlying tool call is billed at its normal endpoint price; get_sentiment adds a small per-page surcharge. Page through results as needed but stop once you have enough to deliver the outcome.