Skip to content

Bug: search_apple_docs returns 0 results for all queries #36

@AdlerCentauri

Description

@AdlerCentauri

Body:

Environment

  • Version: 1.0.26 (@latest via npx)
  • OS: macOS 26
  • Client: Claude Code CLI

Problem

search_apple_docs returns "No results found" for ANY query, including basic terms:

  • "ModelContext" → 0 results
  • "SwiftData" → 0 results
  • "UIKit" → 0 results
  • "Query" → 0 results
  • "View" → 0 results

Tested with fresh npx cache (deleted ~/.npm/_npx and restarted).

Other tools work fine

All JSON-based tools return correct results:

  • list_technologies
  • search_framework_symbols
  • get_sample_code
  • get_apple_doc_content
  • ✅ All WWDC tools

Suspected cause

Unknown. The tool worked ~7 months ago (last npm release: September 2025).

Looking at the source code, search_apple_docs uses HTML scraping of developer.apple.com/search?q=....

Possible reasons:

  • Apple changed the HTML structure of the search results page
  • Apple changed/removed the endpoint
  • Rate-limiting or blocking

The other tools (search_framework_symbols, get_sample_code, etc.) use JSON endpoints and still work correctly.

Possible solutions

  1. Use a headless browser (Puppeteer/Playwright) to execute JavaScript
  2. Find an alternative Apple API endpoint that returns JSON
  3. Reverse-engineer the XHR/fetch calls that Apple's search page makes

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions