> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 入门总览

> 先判断哪种接入方式最适合你的场景，再进入对应的 SoMark 快速开始页面。

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

## SoMark 有哪些接入方式

<CardGroup cols={3}>
  <Card title="SoMark API" icon="terminal" href="/documentation/api">
    直接调 HTTP 接口。
  </Card>

  <Card title="SoMark CLI" icon="square-terminal" href="/documentation/cli">
    适合终端、脚本和批处理。
  </Card>

  <Card title="SoMark SDK" icon="code" href="/documentation/sdk">
    适合接进代码和服务端。
  </Card>

  <Card title="SoMark Skill" icon="wand-magic-sparkles" href="/documentation/skill">
    适合 Agent 平台里的 Skill 接入。
  </Card>

  <Card title="SoMark MCP" icon="plug" href="/documentation/mcp">
    适合 MCP 客户端里的助手调用。
  </Card>
</CardGroup>

## 场景与接入方式

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

## 同步还是异步解析

SoMark 支持同步和异步两种解析模式。选择哪种取决于你的处理场景和文件大小。

| 场景                     | 推荐方式                      | 说明                     |
| ---------------------- | ------------------------- | ---------------------- |
| 需要立即得到结果，文件较小（\< 30MB） | [同步解析](/quickstart-sync)  | 一次请求直接返回解析结果，适合快速反馈场景。 |
| 处理较大文件或批量文档（> 30MB）    | [异步解析](/quickstart-async) | 先提交任务，后查询结果，适合长时间处理。   |