Mapbox Search Patterns
This is essentially a decision tree for anyone working with Mapbox's search APIs. It tells you which tool to reach for based on query type: search_and_geocode for specific places and brands, category_search for generic types like "coffee shops nearby", and reverse_geocode for coordinates to addresses. The real value is in the parameter guidance, especially around proximity versus bbox versus country filters. Proximity biases results without hard boundaries, bbox creates strict geographic constraints, and you can combine them. The tool selection matrix is handy when you're second-guessing whether "Target stores" should use the brand search or category search (it's brand, even when plural).
- skills.sh installs
- 1.9K
- GitHub stars
- 86
- last updated
- Aug 21, 2026
Install
$ npx -y skills add mapbox/mapbox-agent-skills --skill mapbox-search-patterns --agent claude-codeInstalls into .claude/skills of the current project.
Files
Mapbox Search Patterns Skill
Expert guidance for AI assistants on using Mapbox search tools effectively. Covers tool selection, parameter optimization, and best practices for geocoding, POI search, and location discovery.
Available Search Tools
1. search_and_geocode_tool
Best for: Specific places, addresses, brands, named locations
Use when query contains:
- Specific names: "Starbucks on 5th Avenue", "Empire State Building"
- Brand names: "McDonald's", "Whole Foods"
- Addresses: "123 Main Street, Seattle", "1 Times Square"
- Chain stores: "Target"
- Cities/places: "San Francisco", "Portland"
Don't use for: Generic categories ("coffee shops", "museums")
2. category_search_tool
Best for: Generic place types, categories, plural queries
Use when query contains:
- Generic types: "coffee shops", "restaurants", "gas stations"
- Plural forms: "museums", "hotels", "parks"
- Is-a phrases: "any coffee shop", "all restaurants", "nearby pharmacies"
- Industry terms: "electric vehicle chargers", "ATMs"
Don't use for: Specific names or brands
3. reverse_geocode_tool
Best for: Converting coordinates to addresses, cities, towns, postcodes
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/mapbox/mapbox-agent-skills
- Categories
- AI & Agent Building, Sales & Marketing
- First seen
- May 16, 2026
More from mapbox/mapbox-agent-skills
All 18- Mapbox Store Locator Patterns1.7K
- Mapbox Mcp Devkit Patterns1.6K
- Mapbox Ios Patterns1.5K
- Mapbox Android Patterns1.5K
- Mapbox Google Maps Migration1.5K
- Mapbox Mcp Runtime Patterns1.4K
- Mapbox Maplibre Migration1.4K
- Mapbox Location Grounding1.3K
- Mapbox Web Integration Patterns2.7K
- Mapbox Web Performance Patterns2.5K
- Mapbox Style Patterns2.4K
- Mapbox Geospatial Operations2.3K
- Mapbox Data Visualization Patterns2.2K
- Mapbox Cartography2.2K
- Mapbox Style Quality2K
- Mapbox Token Security2K
- Mapbox Search Integration1.9K
Recommended
More AI & Agent Building
publish-to-pagesgithub/awesome-copilotPublish presentations and web content to GitHub Pages. Converts PPTX, PDF, HTML, or Google Slides to a live GitHub Pages URL. Handles repo creation, file conver1.9Kskills.sh installs
meshy-3d-printingmeshy-dev/meshy-3d-agent3D print models generated with Meshy AI, plus Creative Lab consumer products. Handles slicer detection, white model printing, multi-color printing via API, the 1.9Kskills.sh installs
workflow-automationhubspot/agent-cli-skillsList, inspect, create, update, and delete HubSpot workflows (v4 flows API) from the `hubspot` agent CLI, not the `hs` developer CLI.1.9Kskills.sh installs
novelty-assessmentlingzhi227/agent-research-skillsAssess research idea novelty through systematic literature search. Multi-round search-evaluate loops with harsh critic persona. Binary novel/not-novel decision 1.9Kskills.sh installspaper-writing-sectionlingzhi227/agent-research-skillsWrite a specific section of an academic paper (Abstract, Introduction, Background, Related Work, Methods, Experiments, Results, Discussion/Conclusion) with sect1.8Kskills.sh installs
pdfk-dense-ai/scientific-agent-skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple P1.8Kskills.sh installs