@roilab/crm-cli 0.12.0 → 0.14.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.
@@ -1,60 +1,60 @@
1
- ---
2
- name: tool-routing
3
- description: Elige entre las herramientas externas de SEO local que tiene la agencia (Screaming Frog, Ahrefs, BrightLocal, LocalSEOData, Local Falcon, Semrush, SerpAPI, DataForSEO, Whitespark, LSA Spy, Google Search Console, Google Analytics). Úsalo cuando hay que decidir qué tool atacar una tarea antes de cargar el skill específico de esa herramienta.
4
- when_to_use: "qué tool uso para X", "con qué herramienta audito Y", "¿Screaming Frog o Ahrefs?", "cuál es la mejor para citations", "qué tool tiene datos de backlinks", "tool para geogrid", "tool para reviews"
5
- ---
6
-
7
- # Tool Routing
8
-
9
- Decide qué herramienta externa usar para cada tipo de tarea antes de cargar
10
- el skill detallado. Cada fila de la tabla apunta al skill con la doc completa
11
- de ese tool.
12
-
13
- ## Matriz de decisión
14
-
15
- | Necesitas | Tool primario | Skill a cargar | Alternativas |
16
- |---|---|---|---|
17
- | Decidir si crear una tarea (duplicados + recall + cargas) | `crm task preflight` | `task-preflight` | — (siempre primero, antes de cualquier task create) |
18
- | Optimizar / validar meta title + meta description de una URL | `crm rank` + `crm gsc query` | `optimizar-metas` (skill de agencia — `crm skill pull optimizar-metas`) | — (metodología: tracker sin créditos → GSC → SERP → canibalización) |
19
- | Auditoría técnica de sitio (crawl completo) | Screaming Frog | `screaming-frog-tool` | Semrush site audit (ligero) |
20
- | Análisis de páginas de ubicación a escala | Screaming Frog | `screaming-frog-tool` | — |
21
- | Extracción custom (NAP, schema) | Screaming Frog | `screaming-frog-tool` | — |
22
- | Backlinks / referring domains / link gap | Ahrefs | `ahrefs-tool` | LocalSEOData (`backlink_summary`, `backlink_gap`) para overviews rápidos |
23
- | Anchor text / lost links | Ahrefs | `ahrefs-tool` | — |
24
- | Auditoría de citations + NAP consistency | BrightLocal / LocalSEOData | `brightlocal-tool` / `localseodata-tool` | Whitespark (más profundo) |
25
- | Descubrir listings desconocidos | LocalSEOData | `localseodata-tool` | — |
26
- | Geogrid scan (rankings por geolocalización) | Local Falcon | `local-falcon-tool` | LocalSEOData `geogrid_scan` (one-off) |
27
- | Auditoría integral en una llamada | LocalSEOData | `localseodata-tool` | — |
28
- | Keyword research (volumen, dificultad, intent) | Semrush | `semrush-tool` | Ahrefs (secundario) |
29
- | SERP snapshots / análisis de SERPs | SerpAPI | `serpapi-tool` | DataForSEO SERP |
30
- | Datos crudos de Google (SERP + Ads) | DataForSEO | `dataforseo-tool` | SerpAPI (más simple) |
31
- | Local Services Ads (LSA) ranking / precios | LSA Spy | `lsa-spy-tool` | — |
32
- | Descubrimiento de directorios / data aggregators | Whitespark | `whitespark-tool` | BrightLocal |
33
- | Performance orgánico (clicks, impresiones, queries) | Google Search Console | `google-search-console-tool` | — (única fuente de verdad) |
34
- | Tráfico y conversiones | Google Analytics | `google-analytics-tool` | — (única opción) |
35
- | Reviews (Google Maps) | LocalSEOData | `localseodata-tool` | BrightLocal |
36
-
37
- ## Preguntas que el agente debería hacer antes de elegir
38
-
39
- 1. ¿El usuario ya tiene exportado un CSV de alguna herramienta? → lo analizas tú, no hace falta tool nuevo.
40
- 2. ¿Es monitoreo recurrente o análisis puntual? → monitoreo → LocalSEOData/Local Falcon; puntual → Screaming Frog / Ahrefs.
41
- 3. ¿El cliente paga esa herramienta? Pregunta si no está claro — no asumas acceso.
42
- 4. ¿Lo pide la agencia (IP interno) o es investigación pública? → para IP interno, GBP/GSC/GA4; para investigación, SerpAPI/DataForSEO.
43
-
44
- ## Anti-patrones
45
-
46
- - **No cargues varios tool-skills a la vez.** Cada uno trae una tabla "When to Use X vs Y" — si cargas ahrefs-tool + semrush-tool simultáneamente, duplicas contexto. Usa este skill para elegir, luego carga uno.
47
- - **No inventes endpoints.** Si no hay skill cargado, dile al usuario que exporte el CSV y tú lo lees — es más realista que pretender una integración que no existe.
48
- - **No recomiendes el tool de mayor precio por defecto.** Ahrefs + Semrush son caros. Si el cliente solo necesita un overview, LocalSEOData o GSC cubren el 80% gratis.
49
-
50
- ## Workflow típico
51
-
52
- ```
53
- 1. Usuario: "Audítame el SEO local de cliente X"
54
- 2. Agente: carga `tool-routing` (este skill)
55
- 3. Agente: identifica qué subtareas componen la auditoría
56
- 4. Agente: carga los 2-3 skills específicos necesarios
57
- (ej. `local-seo-audit` como playbook + `localseodata-tool` + `screaming-frog-tool`)
58
- 5. Agente: ejecuta la auditoría. Si un tool no está disponible, degrada
59
- a la alternativa de la matriz arriba y avisa al usuario.
60
- ```
1
+ ---
2
+ name: tool-routing
3
+ description: Elige entre las herramientas externas de SEO local que tiene la agencia (Screaming Frog, Ahrefs, BrightLocal, LocalSEOData, Local Falcon, Semrush, SerpAPI, DataForSEO, Whitespark, LSA Spy, Google Search Console, Google Analytics). Úsalo cuando hay que decidir qué tool atacar una tarea antes de cargar el skill específico de esa herramienta.
4
+ when_to_use: "qué tool uso para X", "con qué herramienta audito Y", "¿Screaming Frog o Ahrefs?", "cuál es la mejor para citations", "qué tool tiene datos de backlinks", "tool para geogrid", "tool para reviews"
5
+ ---
6
+
7
+ # Tool Routing
8
+
9
+ Decide qué herramienta externa usar para cada tipo de tarea antes de cargar
10
+ el skill detallado. Cada fila de la tabla apunta al skill con la doc completa
11
+ de ese tool.
12
+
13
+ ## Matriz de decisión
14
+
15
+ | Necesitas | Tool primario | Skill a cargar | Alternativas |
16
+ |---|---|---|---|
17
+ | Decidir si crear una tarea (duplicados + recall + cargas) | `crm task preflight` | `task-preflight` | — (siempre primero, antes de cualquier task create) |
18
+ | Optimizar / validar meta title + meta description de una URL | `crm rank` + `crm gsc query` | `optimizar-metas` (skill de agencia — `crm skill pull optimizar-metas`) | — (metodología: tracker sin créditos → GSC → SERP → canibalización) |
19
+ | Auditoría técnica de sitio (crawl completo) | Screaming Frog | `screaming-frog-tool` | Semrush site audit (ligero) |
20
+ | Análisis de páginas de ubicación a escala | Screaming Frog | `screaming-frog-tool` | — |
21
+ | Extracción custom (NAP, schema) | Screaming Frog | `screaming-frog-tool` | — |
22
+ | Backlinks / referring domains / link gap | Ahrefs | `ahrefs-tool` | LocalSEOData (`backlink_summary`, `backlink_gap`) para overviews rápidos |
23
+ | Anchor text / lost links | Ahrefs | `ahrefs-tool` | — |
24
+ | Auditoría de citations + NAP consistency | BrightLocal / LocalSEOData | `brightlocal-tool` / `localseodata-tool` | Whitespark (más profundo) |
25
+ | Descubrir listings desconocidos | LocalSEOData | `localseodata-tool` | — |
26
+ | Geogrid scan (rankings por geolocalización) | Local Falcon | `local-falcon-tool` | LocalSEOData `geogrid_scan` (one-off) |
27
+ | Auditoría integral en una llamada | LocalSEOData | `localseodata-tool` | — |
28
+ | Keyword research (volumen, dificultad, intent) | Semrush | `semrush-tool` | Ahrefs (secundario) |
29
+ | SERP snapshots / análisis de SERPs | SerpAPI | `serpapi-tool` | DataForSEO SERP |
30
+ | Datos crudos de Google (SERP + Ads) | DataForSEO | `dataforseo-tool` | SerpAPI (más simple) |
31
+ | Local Services Ads (LSA) ranking / precios | LSA Spy | `lsa-spy-tool` | — |
32
+ | Descubrimiento de directorios / data aggregators | Whitespark | `whitespark-tool` | BrightLocal |
33
+ | Performance orgánico (clicks, impresiones, queries) | Google Search Console | `google-search-console-tool` | — (única fuente de verdad) |
34
+ | Tráfico y conversiones | Google Analytics | `google-analytics-tool` | — (única opción) |
35
+ | Reviews (Google Maps) | LocalSEOData | `localseodata-tool` | BrightLocal |
36
+
37
+ ## Preguntas que el agente debería hacer antes de elegir
38
+
39
+ 1. ¿El usuario ya tiene exportado un CSV de alguna herramienta? → lo analizas tú, no hace falta tool nuevo.
40
+ 2. ¿Es monitoreo recurrente o análisis puntual? → monitoreo → LocalSEOData/Local Falcon; puntual → Screaming Frog / Ahrefs.
41
+ 3. ¿El cliente paga esa herramienta? Pregunta si no está claro — no asumas acceso.
42
+ 4. ¿Lo pide la agencia (IP interno) o es investigación pública? → para IP interno, GBP/GSC/GA4; para investigación, SerpAPI/DataForSEO.
43
+
44
+ ## Anti-patrones
45
+
46
+ - **No cargues varios tool-skills a la vez.** Cada uno trae una tabla "When to Use X vs Y" — si cargas ahrefs-tool + semrush-tool simultáneamente, duplicas contexto. Usa este skill para elegir, luego carga uno.
47
+ - **No inventes endpoints.** Si no hay skill cargado, dile al usuario que exporte el CSV y tú lo lees — es más realista que pretender una integración que no existe.
48
+ - **No recomiendes el tool de mayor precio por defecto.** Ahrefs + Semrush son caros. Si el cliente solo necesita un overview, LocalSEOData o GSC cubren el 80% gratis.
49
+
50
+ ## Workflow típico
51
+
52
+ ```
53
+ 1. Usuario: "Audítame el SEO local de cliente X"
54
+ 2. Agente: carga `tool-routing` (este skill)
55
+ 3. Agente: identifica qué subtareas componen la auditoría
56
+ 4. Agente: carga los 2-3 skills específicos necesarios
57
+ (ej. `local-seo-audit` como playbook + `localseodata-tool` + `screaming-frog-tool`)
58
+ 5. Agente: ejecuta la auditoría. Si un tool no está disponible, degrada
59
+ a la alternativa de la matriz arriba y avisa al usuario.
60
+ ```