feat: add search_mapbox_docs_tool powered by Algolia

[mattpodwysocki]

Summary

• Adds search_mapbox_docs_tool — searches all Mapbox documentation via the Algolia index that powers the search box on docs.mapbox.com
• Returns ranked results with titles (breadcrumb hierarchy), anchor URLs, and content excerpts
• Strips Algolia HTML highlight tags before returning to keep output clean
• 8 unit tests covering happy path, empty results, error handling, HTML stripping, null content, and default limit

How it works

The Algolia app ID, search-only API key, and index name are public credentials embedded in every docs.mapbox.com browser session. We POST a query to the Algolia search API and format the ranked hits as markdown.

Typical workflow for an LLM:

1. search_mapbox_docs_tool("add a marker to a map") → get ranked results with URLs
2. get_document_tool(url) → fetch the full page content for the best match

Example output

1. **Mapbox GL JS > Examples > Add a marker to the map**
   URL: https://docs.mapbox.com/mapbox-gl-js/example/add-a-marker/
   > Use a Marker to add a visual indicator to the map.

2. **Maps SDK for iOS > Markers > Adding a basic marker**
   URL: https://docs.mapbox.com/ios/maps/guides/add-your-data/markers/#basic-marker
   > The simplest way to add a marker is to specify a coordinate.

🤖 Generated with Claude Code