sosumi.ai

Making Apple docs AI-readable.

sosumi.ai provides Apple Developer documentation in an AI-readable format by converting JavaScript-rendered pages into Markdown.

Usage

HTTP API

Replace developer.apple.com with sosumi.ai in any Apple Developer documentation URL:

Original:

https://developer.apple.com/documentation/swift/array

AI-readable:

https://sosumi.ai/documentation/swift/array

This works for all API reference docs, as well as Apple's Human Interface Guidelines (HIG).

WWDC session transcripts are also supported by replacing the same host for video URLs:

Original:

https://developer.apple.com/videos/play/wwdc2021/10133/

AI-readable:

https://sosumi.ai/videos/play/wwdc2021/10133

Sosumi can also proxy public non-Apple Swift-DocC pages using:

Original:

https://swiftlang.github.io/swift-docc-plugin/documentation/swiftdoccplugin

AI-readable:

https://sosumi.ai/external/https://swiftlang.github.io/swift-docc-plugin/documentation/swiftdoccplugin

[!NOTE] Sosumi resolves the URL to the site's underlying DocC JSON endpoint and renders Markdown, preserving any base path from the original URL. External hosts can opt out via robots.txt by disallowing user-agent sosumi-ai (full UA: sosumi-ai/1.0 (+https://sosumi.ai/#bot)). See /bot for the crawler policy and contact details.

MCP Integration

Sosumi's MCP server supports the Streamable HTTP transport. If your client supports it, configure it to connect directly to https://sosumi.ai/mcp.

If your client supports stdio but not Streamable HTTP, such as a client whose only remote transport is the older HTTP+SSE transport, you can run this command to proxy over stdio:

{
  "mcpServers": {
    "sosumi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://sosumi.ai/mcp"]
    }
  }
}

See the website for client-specific instructions.

Plugin

The plugin folder packages the MCP server and the agent skill for Claude Code, Cursor, and Agent Plugins clients such as ChatGPT and Codex.

In Claude Code, run:

/plugin marketplace add NSHipster/sosumi.ai
/plugin install sosumi@sosumi-ai

public/SKILL.md is the source of the skill. After you edit it, copy it into the plugin:

cp public/SKILL.md plugin/skills/sosumi/SKILL.md

A test fails when the two files differ.

Available Tools

• searchAppleDocumentation - Searches Apple Developer documentation

  • Parameters: query (string)
  • Returns structured results with titles, URLs, descriptions, breadcrumbs, and tags

• fetchAppleDocumentation - Fetches Apple Developer documentation and Human Interface Guidelines by path

  • Parameters: path (string) - Documentation path (e.g., '/documentation/swift', '/documentation/swiftui/view', '/design/human-interface-guidelines/foundations/color')
  • Returns content as Markdown

• fetchAppleVideoTranscript - Fetches video transcripts, including WWDC sessions

  • Parameters: path (string) - video path (e.g., /videos/play/wwdc2021/10133)
  • Returns transcript content as Markdown

• fetchExternalDocumentation - Fetches external Swift-DocC documentation by absolute HTTPS URL

  • Parameters: url (string) - External URL (e.g., https://swiftlang.github.io/swift-docc-plugin/documentation/swiftdoccplugin)
  • Returns content as Markdown

CLI

Sosumi also provides a CLI that complements MCP:

npx @nshipster/sosumi fetch https://developer.apple.com/documentation/swift/array

If you use it regularly, install once:

npm i -g @nshipster/sosumi

Then use sosumi directly:

sosumi fetch https://developer.apple.com/documentation/swift/array

You can fetch all content types covered by MCP tools:

... [View full README on GitHub](https://github.com/nshipster/sosumi.ai#readme)