Available integration paths
SoMark API
Direct HTTP integration.
SoMark CLI
Best for terminals, scripts, and batch jobs.
SoMark SDK
Best for apps, services, and code integration.
SoMark Skill
Best for Skill-based agent platforms.
SoMark MCP
Best for MCP-based AI clients.
Scenarios and integration paths
| Scenario | Recommended | Details |
|---|---|---|
| Need fine-grained API control | SoMark API | Standard low-level interface. API fields are the source of truth. |
| Need quick validation or batch tasks | SoMark CLI | Use directly from the command line without writing application code. |
| Need integration in a Python or JavaScript app | SoMark SDK | Purpose-built for engineering integration, with retry logic, timeouts, and dependency management. |
| Need integration in an agent workflow | SoMark Skill | Aligns with platform workflow patterns and reduces wrapper code. |
| Need direct use from an MCP client | SoMark MCP | Purpose-built for MCP client integration with natural-language commands. |
Sync vs. async parsing
SoMark supports both sync and async parsing modes. Choose based on your processing scenario and file size.| Scenario | Recommended | Details |
|---|---|---|
| Need immediate results with small files (< 30MB) | Sync parsing | Returns results immediately in a single request. Best for real-time feedback. |
| Processing large files or batch documents (> 30MB) | Async parsing | Submit job and query results later. Best for long-running processing. |