跳转到主要内容
开始使用 SoMark 前，请先明确你的场景需求。SoMark 提供多种接入方式来适应不同场景：直接调用 HTTP 接口、终端脚本、代码集成、Agent 平台工具、MCP 客户端等。

​
SoMark 有哪些接入方式

SoMark API

直接调 HTTP 接口。

SoMark CLI

适合终端、脚本和批处理。

SoMark SDK

适合接进代码和服务端。

SoMark Skill

适合 Agent 平台里的 Skill 接入。

SoMark MCP

适合 MCP 客户端里的助手调用。

​
场景与接入方式

场景推荐方式说明
需要精细控制接口调用SoMark API底层标准接口，字段和行为以 API 文档为准。
需要快速验证或运行批处理任务SoMark CLI无需编写业务代码，直接在命令行使用。
需要集成到 Python 或 JavaScript 应用SoMark SDK提供工程化集成支持，包括重试、超时和依赖管理。
需要接入 Agent 平台工作流SoMark Skill符合平台工作流模式，减少重复的包装代码。
需要在 MCP 客户端中直接调用SoMark MCP适配 MCP 客户端模式，支持自然语言驱动。

​
同步还是异步解析

SoMark 支持同步和异步两种解析模式。选择哪种取决于你的处理场景和文件大小。
场景推荐方式说明
需要立即得到结果，文件较小（< 30MB）同步解析一次请求直接返回解析结果，适合快速反馈场景。
处理较大文件或批量文档（> 30MB）异步解析先提交任务，后查询结果，适合长时间处理。