SuperAPI AI 工具集

wecom-smartsheet-api

编程与开发

查看项目

更新于 10-15 17:29

技能介绍

用途:通过 dop-api/opendoc 接口直接只读获取企业微信智能表格数据,不依赖浏览器 JS 内存,适合脱离浏览器读取、批量导出、定时抓取以及与其他系统集成。

主要能力:核心接口为 GET https://doc.weixin.qq.com/dop-api/opendoc;支持自动分页读取,可通过环境变量控制起始行、结束行与分页大小;DEBUG 模式可输出原始 JSON。

Cookie 获取优先级:自动提取 > 环境变量 > 命令行参数。方式一为在浏览器 evaluate 中执行 () => document.cookie 自动提取(需已登录企微文档)。方式二设置环境变量:export WECOM_COOKIE="utype=ww; TOK=xxx; wedoc_sid=xxx; ..."。方式三命令行参数:node scripts/fetch-smartsheet.mjs <url> "<cookie-string>"。方式四引导用户手动提供:打开任意企微文档页面,按 F12 进控制台输入 document.cookie,或通过 Network 面板复制 doc.weixin.qq.com 请求的 Cookie 字段。关键字段包含 wedoc_sid、wedoc_skey、wedoc_ticket、TOK、tdoc_uid(以上必需),utype、wedoc_sids 建议提供;最简单做法是复制完整 document.cookie。

使用方式:读取表格并自动分页:node scripts/fetch-smartsheet.mjs <smartsheet-url>;只读前 10 行:WECOM_ENDROW=10 node scripts/fetch-smartsheet.mjs <url>;调试模式:DEBUG=1 node scripts/fetch-smartsheet.mjs <url>。环境变量包括 WECOM_COOKIE(Cookie 字符串)、WECOM_STARTROW(默认 0)、WECOM_ENDROW(设置后只请求单页)、WECOM_PAGE_SIZE(默认 500)。

限制:仅只读,不能写入或修改表格;Cookie 有效期取决于企微登录态,通常数小时到数天,过期表现为接口返回登录页或 403;数据格式详见 references/snapshot-format.md。安装命令与平台支持暂未提供。