@roilab/crm-cli 0.22.0 → 0.24.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +65 -0
- package/LICENSE +21 -21
- package/README.md +28 -3
- package/SKILL.md +74 -3
- package/SURFACE.txt +512 -479
- package/dist/bin/crm.js +4 -0
- package/dist/bin/crm.js.map +1 -1
- package/dist/src/commands/credential.js +138 -0
- package/dist/src/commands/credential.js.map +1 -0
- package/dist/src/commands/doctor.js +1 -1
- package/dist/src/commands/doctor.js.map +1 -1
- package/dist/src/commands/marketplace.js +158 -0
- package/dist/src/commands/marketplace.js.map +1 -0
- package/dist/src/commands/site.js +126 -0
- package/dist/src/commands/site.js.map +1 -1
- package/dist/src/commands/update.js +79 -0
- package/dist/src/commands/update.js.map +1 -0
- package/dist/src/transport/run.js +20 -0
- package/dist/src/transport/run.js.map +1 -1
- package/dist/src/utils/server-nudge.js +1 -1
- package/dist/src/utils/server-nudge.js.map +1 -1
- package/dist/src/utils/version-check.js +2 -2
- package/dist/src/utils/version-check.js.map +1 -1
- package/package.json +58 -58
- package/skill-bundles/tools/ahrefs-tool/SKILL.md +5 -5
- package/skill-bundles/tools/brightlocal-tool/SKILL.md +5 -5
- package/skill-bundles/tools/dataforseo-tool/SKILL.md +5 -5
- package/skill-bundles/tools/google-analytics-tool/SKILL.md +5 -5
- package/skill-bundles/tools/google-search-console-tool/SKILL.md +5 -5
- package/skill-bundles/tools/local-falcon-tool/SKILL.md +5 -5
- package/skill-bundles/tools/localseodata-tool/SKILL.md +5 -5
- package/skill-bundles/tools/lsa-spy-tool/SKILL.md +5 -5
- package/skill-bundles/tools/screaming-frog-tool/SKILL.md +5 -5
- package/skill-bundles/tools/semrush-tool/SKILL.md +5 -5
- package/skill-bundles/tools/serpapi-tool/SKILL.md +5 -5
- package/skill-bundles/tools/task-preflight/SKILL.md +157 -157
- package/skill-bundles/tools/whitespark-tool/SKILL.md +5 -5
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,71 @@ Todos los cambios notables se documentan aquí. El formato sigue
|
|
|
6
6
|
|
|
7
7
|
## [Sin publicar]
|
|
8
8
|
|
|
9
|
+
## [0.24.0] — 2026-11-13
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- **Ventas de una categoría.** Solo sumaban las fichas que la tenían como
|
|
14
|
+
categoría por defecto, así que categorías como "semillas feminizadas
|
|
15
|
+
exterior", cuyas fichas cuelgan por defecto de otras, salían sin ventas.
|
|
16
|
+
Ahora suman todas las fichas asociadas a la categoría o a sus subcategorías,
|
|
17
|
+
como las lista la tienda, cada una una vez (también en `--top --category` y
|
|
18
|
+
en la revisión de métricas). El puesto de una ficha sigue siendo dentro de su
|
|
19
|
+
categoría por defecto.
|
|
20
|
+
- **Interanual de ventas a medias.** `crm site sales` daba el interanual de 90
|
|
21
|
+
días aunque la tienda no tuviera cargado el año pasado entero (la carga
|
|
22
|
+
inicial era de 400 días y hacen falta 454). Ahora carga 460, las tiendas ya
|
|
23
|
+
cargadas amplían solas su histórico y, si falta parte del año pasado,
|
|
24
|
+
`previousYear.complete` es `false` y el porcentaje sale `null`.
|
|
25
|
+
|
|
26
|
+
### Added
|
|
27
|
+
|
|
28
|
+
- **Redirecciones 301 del blog: `crm site redirect list | create | delete`.**
|
|
29
|
+
Sin plugin de redirecciones ni `.htaccess`, con el mu-plugin
|
|
30
|
+
`roilab-seo-rest` 1.2.0. Post → post es una fusión (el origen a la papelera
|
|
31
|
+
y WordPress responde 301 por su slug antiguo); lo demás va por ruta y el
|
|
32
|
+
origen publicado pasa a la papelera. Comprueba antes que el destino da 200 y
|
|
33
|
+
se indexa, enseña los clics del origen y sus versiones en otros idiomas, y
|
|
34
|
+
después comprueba el 301 y lo registra en la tarea. `--dry-run` para ver el
|
|
35
|
+
plan.
|
|
36
|
+
- **Accesos: `crm credential list | request | fetch`.** Los usuarios y
|
|
37
|
+
contraseñas de las plataformas de un cliente viven cifrados en el CRM y las
|
|
38
|
+
tareas los enlazan. `list` da nombre, URL y usuario, nunca la contraseña.
|
|
39
|
+
`create` guarda uno nuevo (la contraseña por stdin o fichero, nunca como
|
|
40
|
+
argumento) y `link` lo enlaza a una tarea. `request` la pide: la persona dueña de la clave la aprueba en el CRM (solo
|
|
41
|
+
si ella tiene acceso) y el agente la puede leer 15 minutos con `fetch` o
|
|
42
|
+
directamente con `request --wait`. Scopes nuevos `credentials:read`,
|
|
43
|
+
`credentials:write` y `credentials:reveal`; las claves de API ya emitidas no los tienen.
|
|
44
|
+
|
|
45
|
+
## [0.23.0] — 2026-11-11
|
|
46
|
+
|
|
47
|
+
### Added
|
|
48
|
+
|
|
49
|
+
- **Ventas de la tienda: `crm site sales`.** De una ficha o categoría (URL o
|
|
50
|
+
`--ref`): unidades, facturación sin IVA y pedidos de 28 y 90 días con
|
|
51
|
+
interanual, puesto de la ficha en su categoría o las 10 fichas que más
|
|
52
|
+
facturan de la categoría (incluidas sus subcategorías). Con `--top N`
|
|
53
|
+
(`--category`, `--days 28|90|365`): ranking de fichas por facturación. El CRM
|
|
54
|
+
las suma cada noche desde el webservice de PrestaShop (`orders` y
|
|
55
|
+
`order_details`, solo lectura; nada de clientes): pedidos válidos y no
|
|
56
|
+
cancelados de la tienda e idioma de la conexión. `crm site get` de una ficha
|
|
57
|
+
o categoría trae el resumen de 90 días, `crm site list` el estado de las
|
|
58
|
+
ventas de cada tienda y la revisión de métricas de una tarea añade las ventas
|
|
59
|
+
de sus fichas y categorías antes y después.
|
|
60
|
+
- **`crm update`**: actualiza el CLI (`npm i -g @roilab/crm-cli@latest`) y
|
|
61
|
+
enseña antes/después; `--check` solo compara. Los avisos de versión nueva
|
|
62
|
+
ya lo proponen.
|
|
63
|
+
|
|
64
|
+
### Changed
|
|
65
|
+
|
|
66
|
+
- **Versión mínima para cambiar webs.** `crm site update` (también con
|
|
67
|
+
`--dry-run`) responde `BUSINESS_RULE` con un CLI anterior a 0.23.0 y pide
|
|
68
|
+
`crm update`. El resto de comandos no se bloquea.
|
|
69
|
+
- **SKILL.md: "Decidir con datos".** Qué fuente usar para cada pregunta:
|
|
70
|
+
Search Console (búsquedas y posiciones), ventas de la tienda (dinero; nunca
|
|
71
|
+
stock ni GA4) y Analytics (sesiones, interacción y tiempo en página). Ya no
|
|
72
|
+
hace falta actualizar el CLI a mano cada semana: cuando avise, `crm update`.
|
|
73
|
+
|
|
9
74
|
## [0.22.0] — 2026-11-10
|
|
10
75
|
|
|
11
76
|
### Added
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 ROILab Intelligence
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 ROILab Intelligence
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -29,11 +29,13 @@ crm --help
|
|
|
29
29
|
Actualiza con:
|
|
30
30
|
|
|
31
31
|
```bash
|
|
32
|
-
npm i -g @roilab/crm-cli@latest
|
|
32
|
+
crm update # = npm i -g @roilab/crm-cli@latest; --check solo compara
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
|
|
36
|
-
|
|
35
|
+
No hace falta acordarse: el propio CLI comprueba una vez al día si hay una
|
|
36
|
+
versión nueva en npm y el servidor lo recuerda en cada respuesta, siempre por
|
|
37
|
+
stderr. Cambiar webs (`crm site update`) exige una versión mínima: por debajo,
|
|
38
|
+
el servidor pide `crm update`.
|
|
37
39
|
|
|
38
40
|
## Primer login (30 segundos)
|
|
39
41
|
|
|
@@ -94,6 +96,29 @@ la respuesta trae `searchConsole` con sus clics e impresiones de 90 días. El
|
|
|
94
96
|
canonical tiene que ser del mismo dominio y apuntar a una página que responda
|
|
95
97
|
200 y se pueda indexar; si no, se bloquea.
|
|
96
98
|
|
|
99
|
+
### Ventas de la tienda (`crm site sales`)
|
|
100
|
+
|
|
101
|
+
Para decidir con dinero real, no con el stock ni con Analytics. El CRM suma
|
|
102
|
+
cada noche las ventas de las tiendas PrestaShop conectadas (pedidos válidos y
|
|
103
|
+
no cancelados de la tienda e idioma de la conexión, sin IVA; nada de datos de
|
|
104
|
+
clientes). La clave del webservice necesita permiso de lectura (GET) en
|
|
105
|
+
`orders` y `order_details`.
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
crm site sales --url https://www.tienda.com/598-cbd # categoría: 28 y 90 días, interanual, top 10 fichas
|
|
109
|
+
crm site sales --ref product:5090 --connection <id> # ficha: y su puesto en la categoría
|
|
110
|
+
crm site sales --top 50 --connection <id> # ranking de fichas por facturación de 90 días
|
|
111
|
+
crm site sales --top 20 --category 598 --days 28 --connection <id>
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Una categoría suma todas las fichas asociadas a ella o a sus subcategorías,
|
|
115
|
+
como las lista la tienda, no solo las que la tienen por defecto. El interanual compara con las mismas fechas de hace 52 semanas.
|
|
116
|
+
La revisión de métricas de una tarea añade las ventas de sus fichas y
|
|
117
|
+
categorías antes y después.
|
|
118
|
+
|
|
119
|
+
Para comportamiento (sesiones, interacción, tiempo en página) está
|
|
120
|
+
`crm ga4 query --dimensions pagePath`; para dinero, siempre la tienda.
|
|
121
|
+
|
|
97
122
|
Norma de trabajo: ningún cambio se aplica sin el OK explícito de la persona que
|
|
98
123
|
hace la tarea. El agente enseña el `--dry-run`, espera un "sí, publica", aplica y
|
|
99
124
|
deja la decisión en un comentario de la tarea (`--kind decision`).
|
package/SKILL.md
CHANGED
|
@@ -93,6 +93,8 @@ Errors **always** appear on stderr with full envelope, bypassing `--jq`. Exit co
|
|
|
93
93
|
3. Aplica y deja la decisión en un comentario de la tarea: `crm comment create --task <id> --kind decision --body-file decision.md` (qué se aprobó, quién y cuándo).
|
|
94
94
|
El encargo inicial ("haz esta tarea") no es el OK de los cambios concretos. Solo te lo puedes saltar si la persona te dice expresamente, para esa tarea, que apliques sin preguntar.
|
|
95
95
|
|
|
96
|
+
**CLI al día.** No hace falta actualizar a mano cada semana: el CLI avisa solo por stderr cuando hay versión nueva (`[crm] hay una versión nueva…`). Cuando veas ese aviso, ejecuta `crm update` antes de seguir. Cambiar webs exige una versión mínima: por debajo, `crm site update` responde `BUSINESS_RULE` pidiendo `crm update`; actualiza, vuelve a leer las reglas (`crm site rules`) y repite.
|
|
97
|
+
|
|
96
98
|
1. **Preflight ritual antes de `task create` (OBLIGATORIO)**. Una sola llamada antes de cualquier creación de tarea — el server hace fan-out por ti:
|
|
97
99
|
|
|
98
100
|
```bash
|
|
@@ -210,7 +212,7 @@ crm site rules --url <url-de-la-web> # paquete completo + versión; deja con
|
|
|
210
212
|
crm site rules --url <url> # al empezar con cada web (y si cambia la versión)
|
|
211
213
|
crm task get <taskId> # qué pide la tarea
|
|
212
214
|
crm recall <url> # trabajo previo sobre la URL
|
|
213
|
-
crm site get --url <url> --quiet > actual.json # valores de AHORA (h1, metaTitle, metaDescription, content, summary, noindex, canonical)
|
|
215
|
+
crm site get --url <url> --quiet > actual.json # valores de AHORA (h1, metaTitle, metaDescription, content, summary, noindex, canonical) y, en fichas y categorías, ventas de 90 días
|
|
214
216
|
# … preparas los textos nuevos en ficheros UTF-8 …
|
|
215
217
|
crm site update --task <taskId> --url <url> --meta-title-file t.txt --meta-desc-file d.txt --dry-run # diff
|
|
216
218
|
# … enseñas el diff a la persona y esperas su OK explícito ("sí, publica") …
|
|
@@ -230,11 +232,56 @@ Reglas:
|
|
|
230
232
|
- **Cuándo NO usar noindex:** para arreglar una canibalización (se arregla con contenido y enlaces), en una página con clics que la tarea no dice expresamente que hay que quitar, ni "por si acaso". Sí: páginas vacías, duplicadas o de servicio que no deben salir, y siempre porque lo pide la tarea.
|
|
231
233
|
- **Canonical:** URL absoluta del mismo dominio que responda 200 sin redirigir y no tenga noindex; si no, se bloquea. Un canonical a la propia página equivale al automático. No mezcles noindex y canonical a otra URL en la misma página (se avisa).
|
|
232
234
|
- Volver a `index` o `default` no pide permiso: la página tarda en volver a Google; puedes pedir la indexación en Search Console.
|
|
233
|
-
- **Fuera de alcance:** URL/slug
|
|
235
|
+
- **Fuera de alcance:** cambiar la URL/slug, precios, stock, borrar. Eso va por tarea a quien corresponda. Las redirecciones 301 del blog sí se hacen desde aquí (abajo).
|
|
236
|
+
|
|
237
|
+
#### Redirecciones 301 del blog (`crm site redirect`)
|
|
238
|
+
|
|
239
|
+
Para fusionar dos posts, quitar uno que sobra o recolocar una URL del blog (WordPress). Sin plugin de redirecciones y sin tocar el `.htaccess`: lo hace el mu-plugin `roilab-seo-rest` 1.2 del blog. Si el blog no lo tiene, el comando lo dice y no hace nada. La tienda (PrestaShop) sigue por `.htaccess`, fuera del CRM.
|
|
240
|
+
|
|
241
|
+
```bash
|
|
242
|
+
crm site redirect list --url <url-origen> # ¿ya redirige? ¿qué responde ahora?
|
|
243
|
+
crm site redirect create --task <taskId> --from <url-origen> --to <url-destino> --dry-run # plan, clics del origen y versiones en otros idiomas
|
|
244
|
+
# … enseñas el plan y esperas el OK explícito …
|
|
245
|
+
crm site redirect create --task <taskId> --from <url-origen> --to <url-destino> --note "por qué"
|
|
246
|
+
```
|
|
247
|
+
|
|
248
|
+
- **Cómo lo hace.** Post publicado → post publicado es una **fusión**: el origen va a la papelera y su slug pasa a ser un slug antiguo del destino, así que el 301 lo da el propio WordPress (y sigue funcionando aunque se quite el mu-plugin). Lo demás (páginas, categorías, URLs que ya dan 404) va **por ruta**, en la lista del mu-plugin, y si el origen era un post o una página publicada pasa a la papelera para que salga del sitemap. En los dos casos se vacía la caché de la URL.
|
|
249
|
+
- **Antes de redirigir, el contenido.** Una fusión es pasar al destino lo que el origen tenía de útil (con `crm site update` en el destino) y luego redirigir. Primero el contenido, luego la 301, el mismo día.
|
|
250
|
+
- **Destino:** URL final del mismo dominio que responde 200, sin redirigir y sin noindex. Si no, se bloquea. Nada de cadenas: si el destino ya redirige, apunta a la URL final.
|
|
251
|
+
- **Mira `searchConsole` del `--dry-run`:** son los clics del origen de 90 días. Una URL con clics solo se redirige si la tarea lo pide y a la página que mejor responde a esas búsquedas, nunca a la portada ni a una categoría genérica "por si acaso".
|
|
252
|
+
- **Idiomas (WPML).** En los blogs con un dominio por idioma (los de GB: gbthegreenbrand.com, .fr, .it, .pt y .de), cada traducción es otra URL. El `--dry-run` lista en `translations` las versiones del origen en otros idiomas y su pareja en el destino. Cada una se redirige con su propio `create` y una tarea de ese dominio. Si el destino no tiene versión en ese idioma (`to: null`), no la redirijas a ciegas: dilo en la tarea.
|
|
253
|
+
- **Lee la respuesta:** `applied` y `liveCheck` (`ok` = el origen ya responde 301 al destino). Si no sale `ok`, repite `crm site redirect list --url <origen>` en unos minutos y, si sigue igual, dilo en la tarea. El registro de cambios y el seguimiento del destino se crean solos.
|
|
254
|
+
- **Deshacer:** `crm site redirect delete --task <taskId> --from <url-origen>`. Una fusión vuelve con el post de origen como borrador (hay que publicarlo a mano si se quiere recuperar); una ruta sale de la lista.
|
|
255
|
+
- **No uses 301 para** arreglar una canibalización sin fusionar el contenido, ni para quitar de Google algo que debe seguir existiendo (eso es noindex), ni para cambiar el slug de un post vivo (eso va por tarea a quien publica).
|
|
234
256
|
- **PrestaShop multitienda:** escribe en la tienda y el idioma de la conexión y conserva los demás idiomas. PrestaShop guarda el objeto entero y su filtro de HTML puede reescribir textos de otros idiomas (igual que desde el back office): sale en `warnings`.
|
|
235
257
|
- **Sin ráfagas.** Una página detrás de otra; hay servidores que bloquean la IP ante muchas peticiones seguidas.
|
|
236
258
|
- **URL que no se reconoce** (rutas propias de un módulo): usa `--ref product:<id>` / `category:<id>` / `cms:<id>` / `post:<id>` / `page:<id>` junto a `--url`.
|
|
237
259
|
|
|
260
|
+
### Decidir con datos: Search Console, ventas y Analytics
|
|
261
|
+
|
|
262
|
+
Antes de proponer un cambio, mira qué dicen los datos de esa página. Tres fuentes, cada una para lo suyo:
|
|
263
|
+
|
|
264
|
+
| Pregunta | Fuente | Comando |
|
|
265
|
+
|---|---|---|
|
|
266
|
+
| ¿Por qué búsquedas sale esta página y en qué posición? ¿Qué página gana una keyword? | Search Console | `crm gsc query --property <id> --dimension query --filters "page equals <url>; country equals esp; device equals mobile"` (y `--dimension page --filters "query equals <kw>; …"`) |
|
|
267
|
+
| ¿Cuánto vende esta ficha o categoría? ¿Qué fichas facturan más? | Ventas de la tienda | `crm site sales --url <url>` · `crm site sales --top 50 [--category <id>] --connection <id>` |
|
|
268
|
+
| ¿Cómo se comporta la gente en la página (sesiones, interacción, tiempo)? | Analytics (GA4) | `crm ga4 query --property <id> --dimensions pagePath --metrics sessions,engagementRate,averageSessionDuration,userEngagementDuration,screenPageViews,bounceRate --filters "pagePath equals /ruta/"` |
|
|
269
|
+
|
|
270
|
+
**Ventas (`crm site sales`).** Las suma el CRM cada noche desde el webservice de la tienda, sin datos de clientes:
|
|
271
|
+
- Pedidos válidos y no cancelados de la tienda e idioma de la conexión, sin IVA y antes de cupones de carrito. Unidades sin restar devoluciones.
|
|
272
|
+
- De una ficha: 28 y 90 días (hasta ayer) con su interanual (mismas fechas de hace 52 semanas) y su puesto por facturación dentro de su categoría por defecto. De una categoría: la suma de todas las fichas asociadas a ella o a sus subcategorías, como las lista la tienda (no solo las que la tienen por defecto; cada ficha cuenta una vez), y sus 10 fichas que más facturan. `crm site get` de una ficha o categoría ya trae el resumen de 90 días en `sales`.
|
|
273
|
+
- En sumas de varias fichas, `orders` cuenta pedidos por ficha; la facturación y las unidades son exactas.
|
|
274
|
+
- Si `previousYear.complete` es `false`, la tienda no tiene cargado el año pasado entero para esa ventana y el interanual sale `null`: no lo calcules a mano con datos a medias.
|
|
275
|
+
- **Nunca decidas con el stock** (en algunas tiendas no es real) ni con la facturación de Analytics. Para dinero, la tienda.
|
|
276
|
+
- Úsalas para priorizar (qué fichas o categorías trabajar primero), para elegir el destino de un enlace cuando dos páginas compiten y para medir: la revisión de métricas de la tarea añade las ventas de sus fichas y categorías antes y después, con el interanual.
|
|
277
|
+
- Si `available: false`, la tienda no da permiso de lectura de pedidos o aún no se han cargado: dilo en la tarea y sigue con Search Console.
|
|
278
|
+
|
|
279
|
+
**Analytics (`crm ga4 query`).** Para comportamiento, no para dinero:
|
|
280
|
+
- Sirve para ver si una página con tráfico engancha (tasa de interacción, tiempo de interacción, páginas vistas) y comparar antes y después de un cambio de contenido.
|
|
281
|
+
- Páginas con muchas sesiones y poca interacción son candidatas a mejorar el contenido o la intención; páginas con buena interacción y pocas sesiones, a mejorar el title o el enlazado.
|
|
282
|
+
- Compara siempre las mismas ventanas que en Search Console y la misma página (filtro `pagePath`).
|
|
283
|
+
- **La facturación y las compras de GA4 no valen para decidir**: GA4 se queda corto con las ventas reales y en algunas webs la medición de compras está rota. Las reglas de la web (`crm site rules`) dicen si en esa web GA4 vale solo para sesiones.
|
|
284
|
+
|
|
238
285
|
### Seguimiento de URLs (`crm task tracking`)
|
|
239
286
|
|
|
240
287
|
Cada registro de cambios añade su URL al seguimiento de la tarea y la tarea queda vinculada a la propiedad GSC del dominio filtrada a esas URLs. Al completarla, la revisión de métricas se programa sola a 28 días del cierre (`--verify-days` para cambiarlo). Si el trabajo no es de URLs sueltas, cambia el ámbito:
|
|
@@ -250,6 +297,28 @@ crm task tracking set <taskId> --no-auto-verify # programarla a mano
|
|
|
250
297
|
|
|
251
298
|
Las listas van como un solo filtro (GSC combina filtros con AND: diez `equals` darían cero). Las URLs se guardan con y sin barra final para que casen con cómo las tenga Search Console.
|
|
252
299
|
|
|
300
|
+
## Accesos: usuarios y contraseñas (`crm credential`)
|
|
301
|
+
|
|
302
|
+
Las contraseñas de las plataformas de un cliente (Publisuites, un Medium, un panel…) viven cifradas en el CRM, en los accesos del cliente, y las tareas que las necesitan las enlazan. **Nunca las pegues en comentarios, descripciones ni ficheros.**
|
|
303
|
+
|
|
304
|
+
`crm credential list` te da nombre, URL de acceso y usuario, nunca la contraseña. Para usarla, **pídela siempre antes**: la persona dueña de tu clave recibe un aviso en el CRM y la aprueba o rechaza. Solo puede aprobarla si ella misma tiene acceso a esa contraseña. Aprobada, la puedes leer durante 15 minutos y cada lectura queda registrada.
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
crm credential list --task <taskId> # accesos enlazados a la tarea
|
|
308
|
+
crm credential request <id> --task <taskId> --reason "Publicar el enlace de noviembre en Medium" --wait
|
|
309
|
+
# → espera la aprobación y devuelve username + password + loginUrl
|
|
310
|
+
crm credential fetch <requestId> # si no usaste --wait
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
Si creas una cuenta en una plataforma (o encuentras una contraseña pegada en un comentario), guárdala como acceso. La contraseña entra por stdin, nunca como argumento:
|
|
314
|
+
|
|
315
|
+
```bash
|
|
316
|
+
printf '%s' "$PASS" | crm credential create --task <taskId> --label "Medium GB" --url medium.com/m/signin --username seo@cliente.com --password-stdin
|
|
317
|
+
crm credential link <id> --task <otraTarea>
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
Explica el motivo en `--reason` (lo lee quien aprueba). Si la rechazan, no insistas: pregunta. Usa la contraseña solo para esa tarea y no la guardes en ningún sitio.
|
|
321
|
+
|
|
253
322
|
## Revisión de métricas (rutina diaria)
|
|
254
323
|
|
|
255
324
|
Una tarea SEO se **aplica** (se completa, `completedAt` = día del cambio) y se **revisa** N días después. Ese día el servidor:
|
|
@@ -637,6 +706,8 @@ playbooks que se bajan a `.claude/skills/` con `crm skill pull <slug>`:
|
|
|
637
706
|
|
|
638
707
|
Prefer 1 over 2 when it answers the question — Tinybird reads don't touch provider quotas. Drop down to 2 only when you need the dimensional detail.
|
|
639
708
|
|
|
709
|
+
Money questions (what sells, revenue of a product or category) never come from GA4: use `crm site sales` (real shop orders). GA4 is for behaviour (sessions, engagement, time on page).
|
|
710
|
+
|
|
640
711
|
## Things that are not obvious
|
|
641
712
|
|
|
642
713
|
- Task ids start with `tsk_`, domains with `dom_`, scopes with `sco_`. You pass these as the first positional arg to `get`/`update`. Never pass a URL where an id is expected.
|
|
@@ -766,4 +837,4 @@ Two channels surface a stale CLI version, both shown via stderr (never on stdout
|
|
|
766
837
|
- **Cache nudge**: `[crm] hay una versión nueva: X (tienes Y)`. Printed at startup when `~/.config/crm/cache.json` says a newer version exists on npm. The cache auto-refreshes in a detached background child every 24h on any CLI invocation — `crm doctor` is the explicit refresh path.
|
|
767
838
|
- **Server nudge**: when the API stamps `meta.cliUpdate` on the envelope (caller's `X-Crm-Cli-Version` header is behind the server's `RECOMMENDED_CLI_VERSION` / `MIN_CLI_VERSION`). `"soft"` = friendly upgrade hint; `"required"` = louder `ATENCIÓN` block warning the API surface may have moved. Dedupes once per process.
|
|
768
839
|
|
|
769
|
-
Both are non-blocking — they print and continue. If your agent runs in `--quiet` / pipeline mode and you need to suppress stderr, redirect explicitly (`2>/dev/null`) but you'll lose error messages too.
|
|
840
|
+
Both are non-blocking — they print and continue. Update with `crm update` (it runs `npm i -g @roilab/crm-cli@latest` and prints before/after; `crm update --check` only compares). The one exception is writing to websites: `crm site update` refuses CLIs older than the server's minimum for site writes and asks for `crm update`. If your agent runs in `--quiet` / pipeline mode and you need to suppress stderr, redirect explicitly (`2>/dev/null`) but you'll lose error messages too.
|