GUIA_FINAL_PASO_A_PASO.md
Archivo real del paquete para implementar la función. Descárgalo del ZIP para editarlo; no contiene claves privadas.
# AppInitDev IA + MCP — FINAL PLUS EXTENDIDO (V3.0)
**Un solo proyecto, un solo instalador Python, un solo Worker y una única plantilla de 17 tarjetas.** Sustituye el módulo anterior; no ejecutes versiones antiguas. El objetivo es que las herramientas conectadas puedan representar de forma comprobable la marca, su desarrollador declarado, sus aplicaciones Android, redes, artículos y fuentes originales.
**Compatible con:** Windows + Python 3.10+; Hostinger Personal para HTML/CSS/JS/JSON; Cloudflare Workers para MCP. Sin PHP, base de datos ni suscripción adicional obligatoria. **La publicación remota es manual y requiere acceso a tus cuentas.**
## 1. Instalación local — desde cero, sin parámetros
1. Conserva copia de tu `index.html`, de tus datos y de la versión anterior del Worker en Cloudflare.
2. Coloca la carpeta `AppInitDev_IA_MCP/` junto a `apps_full_data.json`, `sitemap.xml`, `humans.txt` y tu contenido HTML. **No modifiques `/pages/` manualmente.**
3. Abre PowerShell en la raíz del sitio y ejecuta:
```powershell
python AppInitDev_IA_MCP/COMPROBAR_ENTREGA.py
python AppInitDev_IA_MCP/INSTALAR_IA.py
python AppInitDev_IA_MCP/VALIDAR_PROYECTO.py
python AppInitDev_IA_MCP/PRUEBAS.py
python AppInitDev_IA_MCP/PRUEBAS_FINAL.py
python AppInitDev_IA_MCP/INTEGRAR_INDEX.py
node AppInitDev_IA_MCP/mcp-cloudflare/PRUEBAS_WORKER.mjs
```
`node` es necesario **solo para las pruebas locales opcionales del Worker en Windows**; no en Hostinger. El instalador ejecuta los generadores, crea los datos y publica localmente las páginas estáticas. Si ya existían `/datos/`, `/ia/`, `/mcp/`, crea un respaldo local mediante `VERSIONES.py` antes de regenerarlos.
## 2. Qué genera y qué significa
| Módulo | Público en Hostinger | Privado en Windows | Observación |
|---|---|---|---|
| Grafo de conocimiento | `/datos/relaciones/{grafo,apps,resumen}.json`, `/ia/relaciones/` | — | Enlaces a apps declarados; temas automáticos y coincidencias de rutas etiquetadas como heurísticas |
| Comparador Play Store | `/datos/play-store/resumen.json`, `/ia/play-store/` | `importaciones/google_play/`, `reportes/play_comparacion_privada.json` | No afirma verificación en vivo ni publica descripciones importadas |
| Laboratorio reconocimiento | `/datos/reconocimiento/resumen.json`, `/ia/reconocimiento/` | `reportes/reconocimiento_100_preguntas.json` | Verifica cobertura de datos, NO modelos externos |
| Impacto IA | `/datos/impacto/resumen.json`, `/ia/impacto/` | `importaciones/impacto/`, `reportes/impacto_privado.json` | Distingue citas Bing, impresiones y clics GSC |
| Idiomas | `/datos/idiomas/{resumen,documentos}.json` | — | Lee lang del HTML local; desconocido queda `no_determinado` |
| Pruebas MCP | `/mcp/pruebas/` | `PRUEBAS_FINAL.py`, `PRUEBAS_WORKER.mjs` | Comprueba herramientas, recursos y prompts |
| Copias/recuperación | No | `backups/versiones/`, `VERSIONES.py` | Restaura archivos locales, NO el Worker remoto |
| Monitor | No | `reportes/monitoreo_privado.json` | Solicitudes acotadas, solo cuando lo ejecutas |
**No presentes la cobertura del laboratorio como porcentaje de citas en IA**, ni valores sin importación como estadísticas de búsqueda. El archivo público `identidad.json` contiene información declarada en tu sitio, no un acceso a Play Console.
## 3. Comparación con Google Play: dos métodos
### A. Sin API (recomendado para comenzar)
Coloca archivos CSV o JSON en `AppInitDev_IA_MCP/importaciones/google_play/`. Ejemplo de CSV UTF-8 con encabezado:
```csv
packageName,language,title,shortDescription,fullDescription
com.ejemplo.app,es-419,Nombre comercial,Descripción corta,Descripción larga
```
Los paquetes de ejemplo NO se añaden al catálogo si no existen en `apps_full_data.json`. El programa compara campos disponibles con el archivo local; el informe privado indica diferencias. Ejecuta `INSTALAR_IA.py` de nuevo para actualizar el resumen. **El comparador no cambia el nombre de las apps ni edita Google Play.**
### B. API oficial opcional con permiso explícito
El script `SINCRONIZAR_PLAY_API.py` necesita una cuenta de servicio con permisos de la API Google Play Developer (Android Publisher), habilitada en la cuenta propietaria, así como `google-auth` y `requests` en tu PC:
```powershell
python -m pip install google-auth requests
$env:APPINITDEV_PLAY_CREDENTIALS = "C:\\RUTA_PRIVADA\\play-service-account.json"
python AppInitDev_IA_MCP/SINCRONIZAR_PLAY_API.py
python AppInitDev_IA_MCP/INSTALAR_IA.py
```
No instales credenciales en `public_html`. Este modo solicita confirmación manual, crea una edición temporal para **leer** localizaciones con `edits.listings.list`, y elimina la edición sin hacer `commit`. Google exige el permiso OAuth `androidpublisher`; puede no ser un permiso estrictamente solo lectura. Consulta los permisos mínimos con tu administrador de Play Console. Si la API falla, no se inventan metadatos.
Referencias oficiales:
- https://developers.google.com/android-publisher/api-ref/rest/v3/edits/insert
- https://developers.google.com/android-publisher/api-ref/rest/v3/edits.listings/list
- https://developers.google.com/android-publisher/api-ref/rest/v3/edits/delete
## 4. Métricas de citas e impacto
Coloca exportaciones locales `bing_ai_*.csv` y/o `gsc_*.csv` en `AppInitDev_IA_MCP/importaciones/impacto/`, vuelve a ejecutar el instalador y revisa `reportes/impacto_privado.json`. El importador reconoce exclusivamente los encabezados explícitos `Citations`, `Cited pages`, `Clicks`, `Impressions`, cuando existan. **La estructura de exportación puede variar; si la columna no existe, no se estima.** Evita combinar periodos solapados y confirma el origen de cada CSV. El panel público solo presenta agregados numéricos, nunca consultas, URLs privadas o credenciales.
## 5. Copias, monitor y calidad
```powershell
python AppInitDev_IA_MCP/VERSIONES.py
python AppInitDev_IA_MCP/MONITOREAR_PUBLICACION.py
python AppInitDev_IA_MCP/scripts/PROBAR_PUBLICACION.py
```
La primera herramienta crea/restaura snapshots con confirmación; la segunda comprueba un conjunto **limitado** de URLs publicadas y guarda el detalle solo en tu PC; la última verifica el Worker y MCP **después** del despliegue. El monitor no se programa por sí solo. Para volver al Worker anterior utiliza el historial de implementaciones de Cloudflare.
## 6. Publicación en Hostinger
Sube únicamente las carpetas generadas de la raíz del sitio a `public_html/`: **`datos/`, `ia/`, `mcp/`** y `index.html` actualizado. Nunca subas `AppInitDev_IA_MCP/`, importaciones, reportes, backups, el archivo de credenciales ni cachés. En los JSON solo deben aparecer datos públicos y agregados. Comprueba las páginas:
- `/ia/relaciones/`, `/ia/play-store/`, `/ia/reconocimiento/`, `/ia/impacto/`, `/mcp/pruebas/`
- `/mcp/tutoriales/ampliacion-final/`, `/mcp/codigo/`, `/mcp/registro/`
- `/datos/identidad.json`, `/datos/relaciones/resumen.json`, `/datos/impacto/resumen.json`
El archivo `URLS_SITEMAP_IA.txt` contiene las URLs nuevas que deben incorporarse a tu generador de sitemap. Mantén canonicals **sin `.html`**.
## 7. Actualizar Cloudflare MCP
En tu Worker existente `appinitdev-mcp`, pega el código de `AppInitDev_IA_MCP/mcp-cloudflare/worker.mjs`, despliega y comprueba:
- `https://appinitdev-mcp.dev-appinitdev.workers.dev/health` debe devolver versión **3.0.0**.
- `tools/list` devuelve **19 herramientas** (14 originales y 5 nuevas).
- `resources/list` devuelve **7 recursos**, y `prompts/list` devuelve **3 prompts**.
- `resources/read` y `prompts/get` deben responder para identificadores permitidos.
El Worker contiene defensas básicas y validación de entradas; configura protección de tráfico global en Cloudflare si resulta necesaria. Las pruebas locales **no garantizan** compatibilidad con todos los clientes MCP ni disponibilidad pública.
## 8. Registro público MCP
Antes de publicar en el registro, valida el Worker real y revisa `registro/server.json` (versión 3.0.0). Sigue la guía `registro/GUIA_REGISTRO.md` o `/mcp/registro/`: descarga el `mcp-publisher` oficial, genera claves Ed25519 **fuera de web pública**, sube solo el archivo público `/.well-known/mcp-registry-auth`, autentica con `login http --domain=appinitdev.com --private-key=...`, valida y publica el descriptor. Debes comprobar el resultado desde tus cuentas. La publicación **no garantiza indexación en buscadores ni citas de asistentes**.
Documentación oficial: https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/cli/commands.md
## 9. Integrar el index principal
```powershell
python AppInitDev_IA_MCP/INTEGRAR_INDEX.py
```
Busca la cuadrícula `<div class="aid-ecosystem__grid" id="aid-ecosystem-grid">` en tu inicio. La única plantilla `PEGAR_EN_INDEX_PRINCIPAL.html` contiene **17 tarjetas del módulo IA/MCP**. El script añade **solo las faltantes**, actualiza el contador y hace respaldo. En el último archivo que compartiste había 28 tarjetas generales y 2 de IA/MCP, de modo que tras la integración debe haber **43 tarjetas**; si tu index cambió, el total también puede variar.
**No copies tarjetas de entregas anteriores ni vuelvas a ejecutar generadores V1.3/V1.4/V1.5/V2.0.**