← Back to Skills Marketplace
kingjus

Textin Parse

by KingJus · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
204
Downloads
2
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install textin-parse
Description
Textin 文档解析 API 封装,支持上传图片/pdf/word/html/excel/ppt/txt 等格式进行版面检测、文字识别、表格识别,生成 markdown 文档及结构化数据。 用于:(1) 解析 PDF/图片/文档为 markdown;(2) 提取文档结构化数据;(3) 识别表格和公式;(4) 提...
README (SKILL.md)

Textin 文档解析

快速开始

第1步:注册获取 API 凭证

首次使用需要先注册 Textin 账号并获取 API 凭证:

  1. 访问注册链接:https://www.textin.com/register/code/3EJS7P
  2. 注册完成后,登录并进入"开发者与账户信息"页面
  3. 获取 x-ti-app-idx-ti-secret-code

获取凭证后,告诉我这两个值,我会帮你配置。

第2步:配置凭证

告诉我你的 x-ti-app-idx-ti-secret-code,我会保存到配置文件中。

第3步:解析文档

配置好凭证后,你可以这样使用:

解析这个PDF文件
解析这张图片为markdown
提取这个文档的目录结构

支持的文件格式

  • 图片:png, jpg, jpeg, bmp, tiff, webp
  • 文档:pdf, doc, docx, html, mhtml, xls, xlsx, csv, ppt, pptx, txt, ofd, rtf
  • 文件大小:最大 500MB

可选参数说明

解析模式 (parse_mode)

  • auto - 由引擎自动选择,适用范围最广
  • scan - 文档统一当成图片解析
  • lite - 轻量版,只输出表格和文字结果
  • parse - 仅电子档文字解析,速度最快
  • vlm - 视觉语言模型解析模式

默认:scan

表格格式 (table_flavor)

  • html - 按 HTML 语法输出表格
  • md - 按 Markdown 语法输出表格
  • none - 不进行表格识别

默认:html

获取图片 (get_image)

  • none - 不返回任何图像
  • page - 返回每一页的整页图像
  • objects - 返回页面内的子图像
  • both - 返回整页图像和图像对象

默认:objects

标题层级 (apply_document_tree)

  • 1 - 生成标题层级
  • 0 - 不生成标题

默认:1

公式识别 (formula_level)

  • 0 - 全识别
  • 1 - 仅识别行间公式
  • 2 - 不识别

默认:0

去水印 (remove_watermark)

  • 0 - 不去水印
  • 1 - 去水印

默认:0

图表识别 (apply_chart)

  • 0 - 不开启图表识别
  • 1 - 开启图表识别,以表格形式输出

默认:0

其他常用参数

  • pdf_pwd - PDF 密码(加密文档时使用)
  • page_start - 从第几页开始解析(PDF 时有效)
  • page_count - 解析的页数(默认 1000,最大 1000)
  • dpi - 坐标基准(72/144/216,默认 144)
  • get_excel - 是否返回 Excel(0 或 1)
  • crop_dewarp - 是否切边矫正(0 或 1)
  • markdown_details - 是否返回 detail 字段(0 或 1,默认 1)
  • page_details - 是否返回 pages 字段(0 或 1,默认 1)

使用示例

基础用法

帮我解析这个PDF文件

指定参数

用 parse 模式解析这个PDF
用 lite 模式解析,输出 markdown 表格
解析这个文件并提取目录

错误码处理

常见错误:

  • 40101 - App ID 或 Secret 为空
  • 40102 - App ID 或 Secret 无效
  • 40003 - 余额不足
  • 40303 - 文件类型不支持

如遇错误,请检查凭证是否正确,或咨询用户。

Usage Guidance
This skill appears to do what it says: it sends files or file-URLs to Textin's API and returns parsed markdown/structured data. Before installing: (1) verify you trust the Textin service and the API domain (api.textin.com) because document contents will be uploaded to that third party; (2) be aware credentials are stored in plaintext at ~/.openclaw/textin-config.json — consider storing them in a secure credential manager or removing the file when not needed; (3) avoid providing high-privilege or unrelated secrets to the skill; (4) if handling sensitive documents, check Textin's data retention/privacy policy and consider redaction or local alternatives; and (5) revoke the API keys if you suspect they were exposed.
Capability Analysis
Type: OpenClaw Skill Name: textin-parse Version: 1.0.0 The skill bundle provides a legitimate integration for the Textin document parsing API, allowing users to convert various file formats (PDF, images, etc.) into Markdown. It includes scripts (scripts/config.sh, scripts/parse.sh, and scripts/parse.py) to manage API credentials and handle file uploads to the official Textin endpoint (api.textin.com). While the SKILL.md documentation contains a referral link for registration, the code logic is transparent, lacks obfuscation, and strictly follows the stated functionality without any signs of data exfiltration or unauthorized execution.
Capability Assessment
Purpose & Capability
Name/description, included scripts, and runtime instructions consistently implement a Textin document-parsing client that uploads files/URLs to https://api.textin.com/ai/service/v1/pdf_to_markdown. Requested inputs (x-ti-app-id and x-ti-secret-code) are appropriate and expected.
Instruction Scope
SKILL.md and the scripts restrict actions to configuring credentials and sending files/URLs to the Textin API for parsing. Note: using the skill will upload document contents (or URLs) to a third-party service — this is expected behavior but important for privacy/compliance.
Install Mechanism
No install spec; the skill is instruction-plus-scripts only. Provided shell and Python scripts run locally and require standard tools (bash, python3, curl/requests). No downloads from untrusted URLs or package installs are present.
Credentials
The skill requests only the Textin App ID and Secret, which is proportional to its function. Implementation stores credentials unencrypted in ~/.openclaw/textin-config.json — functional but a plaintext storage/privacy risk the user should be aware of.
Persistence & Privilege
always=false and the skill does not request elevated/system-wide permissions. It does persist credentials to a file in the user's home directory, which is normal for a client but creates a persistent secret on disk that the user may want to manage or encrypt.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install textin-parse
  3. After installation, invoke the skill by name or use /textin-parse
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of textin-parse - 提供文档解析 API 封装,支持图片、PDF、Word、Excel、PPT、HTML、Txt 等格式。 - 支持版面检测、文字识别、表格和公式识别,生成 Markdown 文档及结构化数据。 - 支持多种文件输出格式和解析模式,可选参数丰富。 - 支持表格、目录结构、图像等内容提取。 - 明确注册、配置和使用流程说明。
Metadata
Slug textin-parse
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Textin Parse?

Textin 文档解析 API 封装,支持上传图片/pdf/word/html/excel/ppt/txt 等格式进行版面检测、文字识别、表格识别,生成 markdown 文档及结构化数据。 用于:(1) 解析 PDF/图片/文档为 markdown;(2) 提取文档结构化数据;(3) 识别表格和公式;(4) 提... It is an AI Agent Skill for Claude Code / OpenClaw, with 204 downloads so far.

How do I install Textin Parse?

Run "/install textin-parse" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Textin Parse free?

Yes, Textin Parse is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Textin Parse support?

Textin Parse is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Textin Parse?

It is built and maintained by KingJus (@kingjus); the current version is v1.0.0.

💬 Comments