Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

sosumi.ai

Post reply on HN
Print view View original

1–10 of 74 posts

Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#1

Post by _mattt »

I got tired of Claude hallucinating Swift APIs. It does a good job at Python and TypeScript, but ask it about SwiftUI and it's basically guessing.

The problem? Apple's docs are JavaScript-rendered, so when you paste URLs into AI tools, they just see a blank page. Copy-pasting works but... c'mon.

So I built something that converts Apple Developer docs to clean markdown. Just swap developer.apple.com with sosumi.ai in any Apple docs URL and you get AI-readable content.

For example:

- Before: https://developer.apple.com/documentation/swift/double

- After: https://sosumi.ai/documentation/swift/double

The site itself is a small Hono app running on Cloudflare Workers. Apple's docs are actually available as structured data, but Apple doesn't make it obvious how to get it. So what this does is map the URLs, fetch the original JSON, and render as Markdown.

It also provides an MCP interface that includes a tool to search the Apple developer website, which is helpful.

Anyway, please give this a try and let me know what you think!

Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown
sosumi.ai

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#4

Post by _mattt »

thomask1995 wrote: post #2

Very interesting. You have any before and after examples? Curious how it handles some of the concurrency stuff. Actors, async/await etc..

Sure, here are a few more examples:

- https://developer.apple.com/documentation/swift/tasklocal

- https://sosumi.ai/documentation/swiftui/button

- https://sosumi.ai/documentation/foundation/measurement

Most of the docs about the language itself live on swift.org (e.g. https://docs.swift.org/swift-book/documentation/the-swift-pr...). I've had pretty good luck getting Claude to write modern Swift code by saying things like "Use Swift 6 structured concurrency instead of GCD". But I could totally see expanding sosumi to include swift.org content, too.

Edit: Another Swift developer life hack: for new language features, copy-pasting the Swift Evolution proposal works pretty well! https://github.com/swiftlang/swift-evolution/tree/main/propo...

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#7

Post by diimdeep »

Could you share what is your motivation behind doing whole domain and web hosting ?

Personally I feel that this whole AI induced problem should even exist in the first place, but even then it is ridiculous, that you have to query some web api to solve this problem, why not just publish parsed and converted to .md set of local files and be done with it.

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#9

Post by sneak »

_mattt wrote: post #8
edomyrots wrote: post #6

Do you have a public repo? Would love to see how it's working.

Not yet, but I plan to open source it soon. Just gotta tidy up a little bit, you know?

Why do people always say this?

It’s ok to just start coding with a public repo. Code isn’t a secret.

Re: Show HN: Sosumi.ai – Convert Apple Developer docs to AI-readable Markdown

#10

Post by h1fra »

I think it's safe to assume most big players have browser rendering enabled (I hope so). imo AI is struggling with a lot of languages that are not as popular as javascript, mostly because it's more niche and you don't get a lot of good examples on the web.
Post reply on HN