用途:Sosumi 用于在编码智能体需要精确 Apple API 细节时,可靠地把 Apple 文档抓取为 Markdown。适用场景包括 Apple 平台 API(Swift、SwiftUI、UIKit、AppKit、Foundation 等)、API 签名与可用性、参数行为或返回语义、人机界面指南问题、WWDC 会话文字稿查询,以及外部 Swift-DocC 文档(如 GitHub Pages 或 Swift Package Index 托管页面)。
主要能力:提供 HTTP 访问与 MCP 工具两种方式。HTTP 用法是把 developer.apple.com 替换为 sosumi.ai 并保留原路径,例如 https://sosumi.ai/documentation/swift/array。内容类型与路径模式:Apple API 参考为 https://sosumi.ai/documentation/{framework}/{symbol};人机界面指南为 https://sosumi.ai/design/human-interface-guidelines/{topic};Apple 视频文字稿为 https://sosumi.ai/videos/play/{collection}/{id};外部 Swift-DocC 为 https://sosumi.ai/external/{full-https-url}。
MCP 工具:当 Sosumi 配置为 MCP 服务器(https://sosumi.ai/mcp)时,可用 searchAppleDocumentation(query)、fetchAppleDocumentation(path)、fetchAppleVideoTranscript(path)、fetchExternalDocumentation(url)。
使用方式:若已有 developer.apple.com URL,替换主机为 sosumi.ai 并保留路径;若不知道确切页面路径,先搜索再抓取最匹配结果;回答实现问题时优先使用具体符号页面而非宽泛的顶层页面。可选 CLI 预检:sosumi --version 确认 CLI 已安装并在 PATH 中;sosumi --help 显示顶层用法;sosumi <command> --help 查看命令专属行为。
最佳实践:路径未知时先搜索;针对编码问题抓取具体符号页;在回答中保留来源链接以便用户核实;引用 Apple 文档页面时直接使用 Sosumi 路径。
限制与排错:404 或输出稀疏通常表示路径错误或过于宽泛,应先搜索再抓取具体结果路径;外部页面无法抓取时,目标主机可能通过 robots.txt 或 X-Robots-Tag 指令阻止访问,可尝试同一符号的另一个规范页面 URL。资料未提供收费、价格、平台支持范围等更多信息。