AgentStack
SKILL verified MIT Self-run

Mapbox

skill-ashish7802-awesome-api-skills-mapbox · by ashish7802

A Claude skill from ashish7802/awesome-api-skills.

No reviews yet
0 installs
9 views
0.0% view→install

Install

$ agentstack add skill-ashish7802-awesome-api-skills-mapbox

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • Prompt-injection patterns
  • Secret / credential exfiltration
  • Dangerous shell & filesystem operations
  • Untrusted network calls
  • Known-malicious package signatures

What it can access

  • Network access No
  • Filesystem access No
  • Shell / process execution No
  • Environment & secrets No
  • Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Mapbox? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

Mapbox API Skill

Overview

Mapbox provides APIs for maps, geocoding, and routing. This skill focuses on the Mapbox Search (Geocoding) and Navigation APIs for backend services.

Installation

npm install @mapbox/mapbox-sdk
pip install mapbox

Authentication

Authenticate using Access Tokens. Default public tokens (pk.*) are for frontends. Secret tokens (sk.*) are for backends.

Core Concepts

  • Geocoding: Converting text (addresses) into geographic coordinates.
  • Isochrone: Calculating areas reachable within a given time.
  • Matrix API: Travel times between many points.

Common Workflows

  1. Instantiate the client with your Secret Token.
  2. Call geocodingService.forwardGeocode.
  3. Extract features[0].center for coordinates.

Error Handling

Catch network errors and parse the message from Mapbox. Check HTTP 422 for unprocessable geometry.

Security

Always use URL restrictions (Referrer matching) on Public Tokens. Keep Secret Tokens completely out of client-side code.

Rate Limits

Geocoding is limited to 600 requests per minute on standard plans.

Best Practices

Cache geocoding results permanently where legally allowed by the Terms of Service to dramatically reduce API costs and latency.

Troubleshooting

If reverse geocoding returns inaccurate results, ensure you are passing the correct types filter (e.g., address, poi).

References

Why use this skill

Use this when your agent works with mapbox — structured patterns beat pasted docs and prevent common hallucinations.

AI pitfalls

  • Referencing CLI flags or config keys that do not exist
  • Using outdated major versions of tools
  • Skipping lockfile or version pinning in examples

Production checklist

  • [ ] Secrets in environment variables, not source code
  • [ ] Error handling and logging in place
  • [ ] Rate limits and timeouts configured

Related skills

  • [react](../react/SKILL.md) — integrates with
  • [vue](../vue/SKILL.md) — integrates with

> Last Verified: 2026-07-02

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Versions

  • v0.1.0 Imported from the upstream source.