外部 API 工具
在终端、MCP 客户端、Codex 或 Claude 中使用 Write2Notes
代理工具包为订阅用户提供 CLI、MCP 服务器和智能体技能，可用于查询积分、转换文件、编译含插图的 LaTeX，以及优化之前的输出。
一个链接即可完成智能体配置
将下方仓库链接或提示词粘贴到 Codex 或 Claude。智能体可安装软件包、读取对应技能说明并配置 MCP，而无需看到您的原始 API 密钥。
https://github.com/write2notes/write2notes-agent-tools
请从 https://github.com/write2notes/write2notes-agent-tools 安装 Write2Notes Agent Tools。配置 CLI，如有 MCP 则一并配置，并使用对应的 Codex 或 Claude 技能说明。不要让我在聊天中粘贴 API 密钥；请告诉我如何在本地 shell 或 MCP 环境中设置 WRITE2NOTES_API_KEY。
本地安装
在邀请制测试期间可能需要 GitHub 访问权限。安装后，在本地环境中设置 API 密钥并运行就绪检查。
1. 安装软件包
python3 -m pip install "write2notes-agent-tools[mcp] @ git+https://github.com/write2notes/write2notes-agent-tools.git"2. 设置 API 密钥并验证
export WRITE2NOTES_API_KEY="w2n_live_..."
write2notes check工具包含内容
CLI
在命令行中转换文件、查询积分、编译 LaTeX、下载输出并发送反馈。
MCP 服务器
将 Write2Notes 操作暴露为 MCP 兼容智能体和桌面客户端的工具。
智能体技能
为 Codex 和 Claude 提供简洁说明，确保安全处理令牌并正确使用 API 流程。
转换控制
文件与输出
将 PDF、JPG、PNG、HEIC 或 HEIF 文件转换为 DOCX、Markdown 或 LaTeX+PDF。单次请求最多可合并 20 个文件为一个输出。
预设与指令
可选择笔记、摘要、试卷、作业、解题、公式表、翻译、幻灯片或自定义指令等预设。
高级 AI
对复杂手写、图表、低质量扫描和更丰富的插图处理使用高级 AI。消耗 3 倍积分，需 Standard 或 Premium 计划。
无障碍输出
请求增强无障碍的 DOCX 或带标签的 LaTeX/PDF 输出，包含文档结构、元数据、标题和插图替代文本（在支持范围内）。无障碍 LaTeX+PDF 使用现代 PDF 标记；本地编译需 TeX Live 2025、最新宏包以及 LuaLaTeX——pdfLaTeX、XeLaTeX 和其他引擎无法使用。
无障碍检查器
分析现有 PDF 或 DOCX，发现可自动检测的无障碍问题，并获得清晰的修复指导。
通过 API 进行自动无障碍检查
将一个 PDF 或 DOCX 发送至 POST /v1/accessibility/check。响应会对文档结构、元数据、文本、图片、表格、公式及其他可检测风险给出通过、警告和失败结果，并列出仍需人工审核的项目。
Basic、Standard 和 Premium 订阅可用。检查不消耗积分，文件不会保存，网站与 API 请求共用每位用户每小时 30 次的限制。自动通过不代表 WCAG 或 PDF/UA 认证。
总体结果的含义
pass- 未发现机器可检测的失败项或审核警告。仍需人工审核；该结果不代表无障碍认证。
needs_review- 未发现明确的自动检查失败，但警告或不确定情况需要人工检查或修正。这不属于完全通过自动检查。
fail- 至少有一项机器可检测的无障碍要求缺失或检查失败。请修正失败项后重新检查。
检查 PDF 或 DOCX
curl -X POST https://YOUR_V1_API_HOST/v1/accessibility/check \
-H "Authorization: Bearer $WRITE2NOTES_API_KEY" \
-F "file=@document.pdf"常用命令
这些命令使用与控制台 API 密钥页面相同的外部 API。
write2notes credits
write2notes convert notes.pdf --format latex_pdf --out-dir out
write2notes latex estimate main.tex --figure figures
write2notes latex compile main.tex --figure figures --out-dir out
write2notes feedback SESSION_ID "Make section 2 clearer." --out-dir out令牌处理
API 密钥仅在控制台中显示一次。请保存在本地环境或 MCP 客户端设置中。不要将原始密钥粘贴到提示词、共享文件或公开 issue 中。