链接读取指南总目录（apiCode=3262）

# 链接读取指南总目录（apiCode=3262） 链接读取（apiCode=3262）是易源 ShowAPI 上的官方自营接口，输入一个 URL，返回该页面的正文。下面 6 篇覆盖从第一次调用到接进 RAG 管道、从返回结构到方案选型的完整路径。 ## 接口一句话速览 `https://route.showapi.com/3262-1?appKey={your_appKey}&url={目标公开网页}`，POST 或 GET 都行，只有一个业务参数 `url`，返回体里 `showapi_res_body.output` 就是正文。 | 项目 | 值 | |------|-----| | 接口编号 | 3262 | | 接入点 | 1 个：获取网页正文（pointCode=1） | | 接口地址 | `https://route.showapi.com/3262-1` | | 请求方式 | POST / GET | | 业务参数 | `url`（String，必填） | | 返回字段 | `showapi_res_body.ret_code`、`showapi_res_body.output` | | 返回格式 | `output` 为 **Markdown** 文本 | | 计费 | 50 厘/次（0.05 元/次），按次计费 | | 并发 | 2 次/秒 | | 接入点说明 | 适用于 UTF-8 编码的公开网页 | ## 全部分层文章 ### 入门层 **1. [链接读取：用 Python 读取任意公开网页的正文（apiCode=3262）](https://www.showapi.com/guides/link-read-quickstart-3262)** 从拿 AppKey 到发出第一次请求，含 Python / cURL / Node.js 三份可直接运行的代码，最后把 `output` 里的 Markdown 渲染成 HTML。 ### 最佳实践层 **2. [链接读取返回结构说明：output 的取值、计费与结果判断](https://www.showapi.com/guides/link-read-empty-output-3262)** 逐项说明返回字段与六类响应形态，给出三层判断顺序、按页面类型的 26 个 URL 实测对照表，以及结果分流的生产代码。 ### 技术深挖层 **3. [链接读取的 output 到底是什么格式：Markdown 结构拆解与二次处理](https://www.showapi.com/guides/link-read-markdown-output-3262)** `output` 在文档中标注为 String，实际返回的是 Markdown 结构。这篇拆开标题、列表、表格、图片、链接六类结构，给出转 HTML、转纯文本、抽图片、切分块四种后处理代码。 ### 场景实战层 **4. [把链接读取接进 RAG 管道：去重、缓存与分块](https://www.showapi.com/guides/link-read-rag-pipeline-3262)** URL 归一化、缓存键设计、空值不入缓存、分块参数、令牌桶限流（并发 2 次/秒）、指数退避重试，一套能直接搬进生产的设计。 ### 选型对比层 **5. [读取公开网页正文的方案怎么选：自建 requests、无头浏览器，还是链接读取](https://www.showapi.com/guides/link-read-vs-selfbuilt-3262)** 四种方案平级对比，按读取规模与数据源可控性给出各自的适用范围与选择条件，不做推荐。 ### 集成层 **6. [把链接读取接进 MCP：在 Cherry Studio、ChatBox 里让模型自己读公开网页](https://www.showapi.com/guides/link-read-mcp-integration-3262)** 用页面给出的 MCP JSON 配置客户端，让支持 MCP 的 AI 客户端直接调用本接口，AppKey 拼在 URL 里。 ## 相关资源 | 资源 | 地址 | |------|------| | 接口详情与在线调试 | https://www.showapi.com/apiGateway/view/3262 | | 获取网页正文接入点 | https://www.showapi.com/apiGateway/view/3262/1 | | 产品价格与档位 | https://www.showapi.com/apiGateway/view/3262?tab=price | | OpenAPI 文档（YAML） | https://www.showapi.com/openapi/market/3262.yaml | | OpenAPI 文档（JSON 视图） | https://www.showapi.com/openapi/market/3262.json | | AppKey 管理 | https://www.showapi.com/console#/myApp | | MCP 服务地址 | `http://www.showapi.com.cn/mcp/3262/{your_appKey}` | ## 阅读建议 第一次接触这个接口，按 1 → 2 → 3 的顺序读，一小时能拿到能用的代码和一份返回结果对照表。 已经接入、需要按返回字段判断结果的，直接跳第 2 篇。 准备把它放进生产管道，第 4 篇是设计层面的，第 5 篇帮你确认这条路要不要走。 用 AI 客户端、想少写一层代码，从第 6 篇开始。 --- 最后实测核对：2026-09-15。接口文档、计费档位与实测结论均以该日读取与实测结果为准；接口能力变更后建议重新核对。