instantclips-mcp 1.7.2 → 1.10.0

package/README.es.md

@@ -63,6 +63,18 @@ guiará por el inicio de sesión la primera vez. Usa un token y el adaptador std
 navegador?», más abajo) solo para scripts y procesos automatizados que no pueden abrir una página
 de inicio de sesión.
 
+### Cualquier agente de programación
+
+Pega esto en Claude Code, Codex o cualquier agente que ejecute comandos. Añade InstantClips por sí
+mismo y después te dice cómo iniciar sesión:
+
+```text
+Configura InstantClips para mí siguiendo las instrucciones de https://app.instantclips.ai/mcp.md
+```
+
+Las instrucciones que sigue están en [app.instantclips.ai/mcp.md](https://app.instantclips.ai/mcp.md): los comandos de abajo, una
+sección por cliente.
+
 ### Claude Code
 
 ```bash
@@ -75,15 +87,13 @@ la carpeta en la que ejecutas el comando.
 
 ### Codex
 
-Añade lo siguiente a `~/.codex/config.toml`, el archivo que leen la CLI de Codex, la extensión de
-Codex para el IDE y la aplicación de escritorio de ChatGPT:
-
-```toml
-[mcp_servers.instantclips]
-url = "https://app.instantclips.ai/mcp"
+```bash
+codex mcp add instantclips --url https://app.instantclips.ai/mcp
 ```
 
-Después ejecuta `codex mcp login instantclips` para iniciar sesión.
+Añade InstantClips a `~/.codex/config.toml`, el archivo que leen la CLI de Codex, la extensión de
+Codex para el IDE y la aplicación de escritorio de ChatGPT, y abre tu navegador para iniciar sesión.
+`codex mcp login instantclips` vuelve a iniciar el inicio de sesión.
 
 ### Cursor y VS Code
 
@@ -212,20 +222,22 @@ El flujo de trabajo, en orden:
 
 1. **Importar** — usa `import_product_from_url` para una página de tienda o
    `create_product_from_images` cuando no haya una página que leer.
-2. **Esperar el borrador** — consulta `get_product` periódicamente hasta que terminen la importación
-   y la preparación del plan.
-3. **Revisarlo y orientarlo** — el plan se devuelve como texto para que el usuario lo revise.
-   `update_video_direction` cambia lo que haga falta y `redraft_video_direction` propone otro
-   enfoque.
+2. **Esperar la importación** — consulta `get_product` periódicamente hasta que `import_status` sea
+   "imported".
+3. **Elegir la idea y revisar el plan** — ofrece las `ideas` del producto, como hace la web. La
+   elección del usuario, o sus propias palabras, va en el `creator_note` de `update_video_direction`,
+   que redacta el plan; `redraft_video_direction` sin idea elige una por él. El plan se devuelve
+   como texto para que el usuario lo revise, y `update_video_direction` cambia lo que haga falta.
 4. **Generar** — usa `generate_video` pasando `expected_credit_cost`: el coste que se le indicó al
    usuario, tal como lo informó `get_product`. Si no coincide, se rechaza sin cobrar.
-5. **Recoger el resultado** — consulta `get_video` periódicamente para obtener el MP4 terminado y
-   un enlace público para compartirlo.
+5. **Recoger el resultado** — consulta `get_video` periódicamente hasta que termine y entrega al
+   usuario el `download_url`, la página propia del vídeo y su enlace público para compartirlo.
 
 Otro vídeo del mismo producto sigue el mismo flujo sobre ese producto: editar o volver a preparar el
 plan abre el borrador del siguiente vídeo, y `generate_video` sin borrador genera otra toma del último
 plan. Un vídeo ya generado no se puede modificar. Cada respuesta de `get_product` incluye `next_step`:
-qué hacer a continuación.
+qué hacer a continuación. Cuando el usuario ha visto un vídeo, `rate_video` registra su valoración;
+`send_feedback` envía al equipo una nota sobre las propias herramientas, con el visto bueno del usuario.
 
 Las marcas funcionan de la misma manera: `list_brands`, `create_brand`, `set_product_brand`. Cada
 vídeo se prepara con la voz de una marca; por eso, si el escaparate de un producto importado no

package/README.md

@@ -58,6 +58,18 @@ Connect to the hosted endpoint directly whenever your client supports Streamable
 you through sign-in on first use. Use a token and the stdio adapter (under "No browser?" below)
 only for scripts and automated runners that cannot open a sign-in page.
 
+### Any coding agent
+
+Paste this into Claude Code, Codex or any agent that runs commands. It adds InstantClips itself,
+then tells you how to sign in:
+
+```text
+Set me up with InstantClips by following the instructions at https://app.instantclips.ai/mcp.md
+```
+
+The instructions it follows are [app.instantclips.ai/mcp.md](https://app.instantclips.ai/mcp.md): the commands below, one section
+per client.
+
 ### Claude Code
 
 ```bash
@@ -69,15 +81,13 @@ every project; without it, Claude Code adds a server only to the folder you run
 
 ### Codex
 
-Add to `~/.codex/config.toml`, which the Codex CLI, the Codex IDE extension and the ChatGPT desktop
-app all read:
-
-```toml
-[mcp_servers.instantclips]
-url = "https://app.instantclips.ai/mcp"
+```bash
+codex mcp add instantclips --url https://app.instantclips.ai/mcp
 ```
 
-Then run `codex mcp login instantclips` to sign in.
+It adds InstantClips to `~/.codex/config.toml`, which the Codex CLI, the Codex IDE extension and the
+ChatGPT desktop app all read, and opens your browser to sign in. `codex mcp login instantclips`
+starts the sign-in again.
 
 ### Cursor and VS Code
 
@@ -200,18 +210,21 @@ The workflow, in order:
 
 1. **Import** — `import_product_from_url` for a store page, or `create_product_from_images` when
    there is no page to read.
-2. **Wait for the draft** — poll `get_product` until the import and the plan have finished.
-3. **Read and steer it** — the plan comes back as text for the user to review.
-   `update_video_direction` changes anything in it, `redraft_video_direction` asks for another
-   angle.
+2. **Wait for the import** — poll `get_product` until `import_status` is "imported".
+3. **Choose the idea, then read the plan** — offer the product's `ideas`, as the website does. The
+   user's pick, or their own words, goes in `update_video_direction`'s `creator_note`, which writes
+   the plan; `redraft_video_direction` with no idea picks one for them. The plan comes back as
+   text for the user to review, and `update_video_direction` changes anything in it.
 4. **Generate** — `generate_video`, passing `expected_credit_cost`: the cost the user was told, as
    `get_product` reported it. A mismatch is refused without charging.
-5. **Collect** — poll `get_video` for the finished MP4 and a public share link.
+5. **Collect** — poll `get_video` until it is done, then give the user `download_url`, the video's
+   own page and its public share link.
 
 Another video for the same product is the same flow on that product: editing or redrafting opens the
 next video's draft, and `generate_video` with no draft renders another take of the last plan. A
 generated video itself cannot be changed. Every `get_product` response carries `next_step`: what to
-do now.
+do now. Once the user has watched a video, `rate_video` records their verdict; `send_feedback` sends
+the team a note about the tools themselves, with the user's OK.
 
 Brands work the same way: `list_brands`, `create_brand`, `set_product_brand`. Every video is
 drafted in a brand's voice, so an import whose storefront matches no existing brand stops and asks

package/README.zh-CN.md

@@ -50,6 +50,16 @@ Cursor 和 VS Code 的一键安装按钮。
 如果客户端支持 Streamable HTTP，请直接连接托管端点，首次使用时会引导你登录。只有脚本和无法打开
 登录页的自动化运行环境，才需要使用令牌和下方“没有浏览器？”一节中的 stdio 适配器。
 
+### 任意编程 agent
+
+把这句话粘贴到 Claude Code、Codex 或任何能运行命令的 agent 里。它会自己添加 InstantClips，再告诉你怎么登录：
+
+```text
+按照 https://app.instantclips.ai/mcp.md 上的说明，为我设置 InstantClips
+```
+
+它照着做的说明在 [app.instantclips.ai/mcp.md](https://app.instantclips.ai/mcp.md)：就是下面这些命令，每个客户端一节。
+
 ### Claude Code
 
 ```bash
@@ -61,14 +71,11 @@ claude mcp add --transport http --scope user instantclips https://app.instantcli
 
 ### Codex
 
-将以下配置添加到 `~/.codex/config.toml`。Codex CLI、Codex IDE 扩展和 ChatGPT 桌面版都会读取这个文件：
-
-```toml
-[mcp_servers.instantclips]
-url = "https://app.instantclips.ai/mcp"
+```bash
+codex mcp add instantclips --url https://app.instantclips.ai/mcp
 ```
 
-然后运行 `codex mcp login instantclips` 登录。
+它会把 InstantClips 添加到 `~/.codex/config.toml`（Codex CLI、Codex IDE 扩展和 ChatGPT 桌面版都会读取这个文件），并打开浏览器让你登录。`codex mcp login instantclips` 可以重新登录。
 
 ### Cursor 和 VS Code
 
@@ -183,16 +190,18 @@ INSTANTCLIPS_TOKEN="your-token" npx -y instantclips-mcp --check --json
 
 1. **导入** — 如果有店铺商品页面，使用 `import_product_from_url`；如果没有可读取的页面，则使用
    `create_product_from_images`。
-2. **等待草稿** — 轮询 `get_product`，直到商品导入和方案起草完成。
-3. **查看并调整** — 方案以文本返回，供用户审阅。
-   使用 `update_video_direction` 修改任何内容，或使用 `redraft_video_direction` 换一个角度。
+2. **等待导入** — 轮询 `get_product`，直到 `import_status` 为 "imported"。
+3. **选择创意，再查看方案** — 像网站一样，提供商品的 `ideas`。用户选中的创意或自己的描述放进
+   `update_video_direction` 的 `creator_note`，由它写出方案；不带创意调用 `redraft_video_direction`
+   则由我们选一个。方案以文本返回，供用户审阅，使用 `update_video_direction` 可修改其中任何内容。
 4. **生成** — 使用 `generate_video`，并传入 `expected_credit_cost`：即 `get_product` 报告并已告知用户的
    算力费用。费用不一致时会拒绝执行，不会扣费。
-5. **获取结果** — 轮询 `get_video`，获取完成的 MP4 文件和公开分享链接。
+5. **获取结果** — 轮询 `get_video` 直到完成，然后把 `download_url`、视频自己的页面和公开分享链接交给用户。
 
 为同一商品制作另一个视频，走的是同一流程：编辑或重新起草会打开下一个视频的草稿；没有草稿时调用
 `generate_video` 会按上一方案再生成一版。已生成的视频本身无法修改。每次 `get_product` 的响应都带有
-`next_step`，说明下一步该做什么。
+`next_step`，说明下一步该做什么。用户看过视频后，`rate_video` 记录用户自己的评价；`send_feedback`
+经用户同意后，把关于这些工具本身的意见发给团队。
 
 品牌的操作方式相同：`list_brands`、`create_brand`、`set_product_brand`。每个视频都会采用对应品牌
 的表达风格进行起草。因此，当导入商品的店铺与任何现有品牌都不匹配时，流程会暂停并询问，而不是