ViewPrinter

ViewPrinter for AI 助手

开发内容形式、制作和审核批次内容，将其安排发布到 TikTok、 Instagram、Facebook、YouTube 和 X，并了解哪些内容表现良好。

安装

npx skills add 1vmgm/viewprinter-plugin    # the five skills, from this repo — any agent
npx skills add https://viewprinter.tech    # the same, as one combined skill

第二个命令中必须带上 scheme：裸主机名会被视为 git 仓库。该域名提供最新发布版本，作为一个组合技能。两者都不会安装 MCP 服务，因为 skills CLI 不支持处理 MCP。要同时安装两者，请在 Claude Code 或 Codex 中安装插件（见下文）。

此插件会将你的助手连接到 ViewPrinter，并提供使用它制作社交内容所需的一切，由五个协同工作的技能组成。托管的 MCP 服务提供这些工具。

技能	用途
content-publishing	连接账号、上传媒体、安排发布和修改帖子、检查投递状态并查看表现
content-production	开发内容形式和项目自己的内容技能，然后据此制作批次内容
content-review	每个项目和内容形式进行一次审核，在一个本地工作区中完成，直至确认安排发布
content-learning	了解哪些帖子和内容形式表现良好，以及接下来该制作什么
account-profiles	管理一组账号的个人简介文案、图片、链接和功能资格

你的品牌和内容形式保存在自己项目的内容技能中，content-production 会帮助你设置它；账号简介也是项目中的文件。此插件保持通用。

这些技能的本地辅助工具需要 Python 3.9 或更高版本（python3；在 Windows 上通常是 python 或 py -3）。检查审核页面时需要 Chrome、Chromium 或 Edge。

你需要一个 ViewPrinter 账号。使用 OAuth 登录，然后连接你想使用的社交账号。无需将 ViewPrinter API 密钥复制到配置中。

各部分的运行位置

• 托管服务器。 ViewPrinter 工具运行于 https://viewprinter.tech/api/mcp。 你的帖子、媒体和账号详情都会发送到那里，因为发布这些内容正是该服务的用途。你使用 OAuth 登录。

• 本地辅助工具。 技能的 Python 脚本在你的计算机上运行。它们会读取和写入项目文件，包括 .viewprinter/content-memory。它们还会使用主目录中的 ViewPrinter 文件夹，其中保存：

  • 审核注册表；
  • 源文件归档；
  • 已搁置的 Tesseract 项目中的部分内容；
  • 你对工具的回答。

  content-production 的 tools.py 会运行每个工具的 --version 来查找你拥有的工具，不会使用浏览器。它只会读取你指定的密钥文件中的变量名称，不会读取变量值。

  只有两个辅助工具会访问外部服务，而且仅在你使用它们时才会访问：

  • describe.py 会将每个原件的小型预览发送到 Google 的 Gemini API，以撰写其描述。它使用你自己的密钥，事先估算费用，并在达到你设置的上限时停止。
  • 审核服务器会通过 ViewPrinter 链接传输审核放行的文件。content-review 的 review_media.py restore 会以相同方式将其下载回来。

  没有任何脚本会上传文件。要将文件上传到 ViewPrinter，连接器的 media_upload 会提供一个指向 ViewPrinter 存储空间、有效期为 15 分钟的上传链接。在终端中，助手会按照发布技能的媒体上传规则，使用 curl 将文件发送到该链接。在 Claude 和 ChatGPT 中，用户则使用上传框。

• 审核页面。 content-review 会在 127.0.0.1:8765 上提供审核页面（可通过 VIEWPRINTER_REVIEW_PORT 更改端口），在浏览器中打开一个标签页，并使用无头 Chrome、Chromium 或 Edge 检查页面；对于本地审核，它不会解析其他主机。

• 预检。 每个技能的 scripts/preflight.sh 都会检查 Python 以及辅助工具能否启动。content-publishing 的预检还会向 ViewPrinter 服务器请求工具列表和登录元数据，不使用凭据。

安装

客户端	安装方式
Codex	此仓库的市场
Claude Code	此仓库的市场
Claude 应用	Claude 目录中的连接器（仅限工具）
ChatGPT	ChatGPT 插件
OpenClaw	ClawHub 技能和 MCP 连接
其他 MCP 客户端	托管服务连接

Codex

codex plugin marketplace add 1vmgm/viewprinter-plugin
codex plugin add viewprinter@viewprinter

在此仓库的检出目录中，codex plugin marketplace add . 也可以正常使用。

开始新的 Codex 会话并询问：

使用 ViewPrinter 显示我已连接的账号，以及哪些账号需要重新连接。

如果系统提示，请完成浏览器登录。该插件包含技能和 MCP 连接；你无需另行配置独立的 MCP。

如需更新、移除和安装独立技能，请参阅 Codex 设置。 如需了解实际测试过的兼容性，请参阅兼容性。

Claude Code

在 Claude Code 中运行以下命令：

/plugin marketplace add 1vmgm/viewprinter-plugin
/plugin install viewprinter@viewprinter

开始新会话，要求使用 ViewPrinter，并在系统提示时完成浏览器登录。/plugin marketplace update viewprinter 会获取新版本。

Claude 应用

ViewPrinter 已作为连接器上架于 Claude 目录：只需点击一次，即可在网页版和桌面版 Claude 中添加这些工具；使用同一个 Claude 账号登录后，也可在 Claude Code 中使用。连接器提供的是工具，而非这些技能；如需在 Claude Code 中使用技能，请安装上方的插件。该插件使用连接器的地址进行连接，因此同时使用两者时，你看到的是同一组工具。

ChatGPT

ViewPrinter 是一个 ChatGPT 插件。 该上架版本采用 OpenAI 最近批准的版本；此处的更改会在下一次获批提交后生效。

试用

• “显示我已连接的账号，以及哪些账号需要重新连接。”
• “将此视频准备为草稿，并保存在 ViewPrinter 中，供我的 TikTok 账号使用。”
• “将这些已批准的帖子安排在下周发布，时间为芝加哥时间上午 9 点。”
• “哪些帖子发布失败了？分别发布到哪些平台？”
• “自上周以来，我的账号增长情况如何？”
• “检查这组账号，并准备个人资料文案、品牌形象和解锁链接清单。”
• “帮我为品牌开发一种内容形式，并为其设置内容技能。”
• “按照该形式制作本周的内容批次，并打开以供审核。”
• “上个月哪些内容形式效果好？接下来应该制作什么？”

助手会根据你的请求选择技能。在 Claude Code 中，你也可以直接调用某项技能，例如 /viewprinter:content-publishing；Codex 的选择器中也会列出相同的命名空间技能。

你可以做什么

领域	功能
格式	开发可重复使用的格式，并将其保存在项目自己的内容技能中
制作	根据格式批量制作内容，并结合项目记忆和原件存档；ViewPrinter 也可以保留这些内容
审核	每个项目和格式在一个本地工作区中进行一次审核：版本、原生字幕、排期凭据
账户	列出并连接账户，识别需要重新连接的账户，读取账户指标
分组	管理用于发布的命名账户集
账户资料	比较当前资料与拟议资料，准备素材和文案，保留有日期的平台调研
媒体	上传、列出、描述和删除已存储的图片、视频和音频；保留原始素材以供重用，绝不直接发布原样素材
帖子	保存草稿、安排发布、修改待发布帖子、取消发布，检查每个发布目标
平台	查看媒体要求、字幕限制和发布选项
学习	将每篇帖子关联到对应的制作格式；加倍投入、调整或淘汰格式

在 Claude 和 ChatGPT 中，media_upload 会显示一个上传框，供用户上传文件； 在其他环境中，它会提供一个 upload_page 链接，或由持有文件的 Agent 将文件 PUT 到一个 短时有效的 URL。此过程没有确认步骤：文件一到达就会被记录。请参阅 媒体上传规则。

保存在 ViewPrinter 中的草稿不会进入队列。平台草稿可以将内容上传到社交平台，供你在那里完成操作。请说明你要哪一种。 只有在所有发布目标都处于待发布状态时，才能更改帖子的字幕和发布目标，但发布时间仍可调整；取消操作无法撤回 已在进行中的发布。账户指标会注明测量时间，并非实时计数。

内容制作工具

发布只需要这个插件。制作媒体则需要针对每项任务使用相应工具。当工作需要工具时， 制作技能会推荐合适的工具，告知安装方法，并在你说“暂时不用”时记下：

任务	工具
视频剪辑、动态图形、声音设计	Mirage 出品的 Tesseract（npx skills add mirage-hq/Tesseract）
媒体转换、封面、帧	ffmpeg
应用演示和屏幕录制	Argent（npx @swmansion/argent@latest init -y）
视频和图像生成	Higgsfield 或 fal，使用你自己的账户
配音和语音字幕	ElevenLabs
视频解析	Gemini API
调研：创作者、帖子、转录文本	Scrape Creators；ViewPrinter 自带的调研功能即将推出
表情包模板	Memelord
应用和 UI 设计参考	Mobbin

它还会让你了解支出情况：每个付费步骤开始前的预计费用、步骤完成后的实际费用和累计总额，以及交付时的批次总额。询问你的 助手你已安装了哪些工具；工具包含所有 设置步骤。

仅使用 MCP 的设置

仅连接 MCP 服务会为你的助手提供工具，但不会安装工作流技能。如果你的客户端不支持插件，或者 你已经单独管理技能，请使用此方式。

端点：https://viewprinter.tech/api/mcp

传输方式：Streamable HTTP · 身份验证：OAuth

独立 Codex 连接：

codex mcp add viewprinter --url https://viewprinter.tech/api/mcp
codex mcp login viewprinter

独立 Claude Code 连接：

claude mcp add -t http viewprinter https://viewprinter.tech/api/mcp

其他客户端有各自的配置格式。请参阅相应的 MCP 说明和 ViewPrinter 连接帮助。

开发与帮助

• 故障排除
• 兼容性与验证
• 软件包验证与发布构建
• 分发与提交状态

skills/ 是所有客户端共用的源。客户端清单用于配置安装；生成的归档文件均来自该源。发布前，变更应通过软件包检查以及受影响客户端的设置检查。

MIT — 详见 LICENSE。