Get a 360-degree read on one city before you expand — local chatter, trending hooks, competitor density, and hiring momentum in a single scan
https://apidirect.io/mcp?token=YOUR_API_KEY
Should I open a {niche} in {city}? Run a full market-entry scan.
city-market-entry-scan.
Any agent can also call get_skill(skill_id="city-market-entry-scan") to pull these steps on demand.
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
| 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 |
search_facebook_locations(query="{city}")
Resolve the city to a numeric location_id so the Facebook post search is geo-scoped to that metro.
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.
twitter_trends(woeid={woeid})
Pull what's trending in the metro right now to spot local events, sentiment, and hooks to localize the launch.
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.
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.
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.
Catch a rising topic, find the B2B founders posting about it, then surface their contact channel.
Turn a map full of local businesses into a contact-rich, multi-platform lead dossier for every place
Prove a niche is not just hot but accelerating by triangulating fresh demand signals across four independent platforms