Skip to content

🚨 URGENT: API docs fetcher broken - platform.claude.com doesn't serve markdown #768

@claude-yolo

Description

@claude-yolo

Problem

The fetcher script is trying to fetch markdown from URLs like:
https://platform.claude.com/docs/en/api/kotlin/messages.md

But platform.claude.com only serves HTML pages at URLs like:
https://platform.claude.com/docs/en/api/kotlin/messages

Impact

  • All API documentation updates fail
  • If accidentally merged, would replace 182+ API docs with HTML 404 pages
  • Users would have completely broken API integration docs

Root Cause

scripts/fetcher.py:140 adds .md suffix to platform URLs:

fetch_url = f"{url}.md"
async with session.get(fetch_url) as response:

Solution Needed

The fetcher needs to distinguish between:

  1. code.claude.com - serves raw markdown at .md URLs ✅
  2. platform.claude.com - serves HTML pages, no .md URLs ❌

Either:

  • Find the correct raw markdown API endpoint for platform docs
  • Parse HTML content and convert to markdown
  • Remove platform.claude.com docs from fetching until proper endpoint found

Closed PRs

💀 WHY URGENT: Would break API docs for all Claude Code users

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions