instantclips-mcp 1.7.2 → 1.9.0

package/README.es.md

@@ -212,20 +212,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

@@ -200,18 +200,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

@@ -183,16 +183,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`。每个视频都会采用对应品牌
 的表达风格进行起草。因此，当导入商品的店铺与任何现有品牌都不匹配时，流程会暂停并询问，而不是