@yoryoboy/bi-mcp 1.0.5 → 1.1.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/README.md +16 -2
- package/dist/.tsbuildinfo +1 -1
- package/dist/index.js +121 -1
- package/dist/index.js.map +2 -2
- package/dist/mcp-use.json +2 -2
- package/dist/src/config/meta.js +29 -0
- package/dist/src/config/meta.js.map +7 -0
- package/dist/src/meta/meta-utils.js +148 -0
- package/dist/src/meta/meta-utils.js.map +7 -0
- package/dist/src/services/meta/meta-ads.js +89 -0
- package/dist/src/services/meta/meta-ads.js.map +7 -0
- package/dist/src/services/meta/meta-api.js +35 -0
- package/dist/src/services/meta/meta-api.js.map +7 -0
- package/dist/src/tools/index.js +1 -0
- package/dist/src/tools/index.js.map +2 -2
- package/dist/src/tools/meta/account-overview.js +92 -0
- package/dist/src/tools/meta/account-overview.js.map +7 -0
- package/dist/src/tools/meta/ad-account-info.js +37 -0
- package/dist/src/tools/meta/ad-account-info.js.map +7 -0
- package/dist/src/tools/meta/ads-performance.js +79 -0
- package/dist/src/tools/meta/ads-performance.js.map +7 -0
- package/dist/src/tools/meta/campaign-performance.js +81 -0
- package/dist/src/tools/meta/campaign-performance.js.map +7 -0
- package/dist/src/tools/meta/index.js +9 -0
- package/dist/src/tools/meta/index.js.map +7 -0
- package/dist/src/tools/meta/list-accessible-ad-accounts.js +44 -0
- package/dist/src/tools/meta/list-accessible-ad-accounts.js.map +7 -0
- package/dist/src/tools/meta/list-accessible-businesses.js +36 -0
- package/dist/src/tools/meta/list-accessible-businesses.js.map +7 -0
- package/dist/src/tools/meta/placement-mix.js +67 -0
- package/dist/src/tools/meta/placement-mix.js.map +7 -0
- package/dist/src/tools/meta/time-series.js +69 -0
- package/dist/src/tools/meta/time-series.js.map +7 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ MCP monolítico de business intelligence para ecommerce en Argentina, construido
|
|
|
4
4
|
|
|
5
5
|
Proyecto está pensado para que usuarios puedan consultar datos reales de operación, marketing y adquisición desde un LLM, usando lenguaje natural, y recibir respuestas útiles para análisis, diagnóstico y toma de decisiones.
|
|
6
6
|
|
|
7
|
-
Hoy el servidor integra VTEX, Google Analytics 4, Search Console, Google Ads y benchmarks de referencia para Argentina. La arquitectura ya está preparada para crecer hacia módulos de finanzas.
|
|
7
|
+
Hoy el servidor integra VTEX, Google Analytics 4, Search Console, Google Ads, Meta Ads y benchmarks de referencia para Argentina. La arquitectura ya está preparada para crecer hacia módulos de finanzas.
|
|
8
8
|
|
|
9
9
|
## Índice
|
|
10
10
|
|
|
@@ -37,6 +37,9 @@ El MCP ya tiene capacidades activas para estas áreas:
|
|
|
37
37
|
- `Google Ads`
|
|
38
38
|
Performance de cuenta, campañas, series temporales, riesgos, break-even y salud de escalabilidad.
|
|
39
39
|
|
|
40
|
+
- `Meta Ads`
|
|
41
|
+
Discovery de businesses y cuentas publicitarias, overview de cuenta, performance de campañas y ads, series temporales y mix de placements.
|
|
42
|
+
|
|
40
43
|
- `Config / Benchmarks AR`
|
|
41
44
|
Benchmarks argentinos de IIBB, cuotas, pasarelas, logística y calendario comercial.
|
|
42
45
|
|
|
@@ -52,6 +55,7 @@ Estado real del repo al día de hoy:
|
|
|
52
55
|
- `Analytics (GA4)`: implementado
|
|
53
56
|
- `Search Console`: implementado
|
|
54
57
|
- `Google Ads`: implementado
|
|
58
|
+
- `Meta Ads`: implementado
|
|
55
59
|
- `Benchmarks Argentina`: implementado
|
|
56
60
|
- `Finance`: pendiente
|
|
57
61
|
- `Diagnostics`: pendiente
|
|
@@ -60,6 +64,7 @@ En términos de superficie funcional actual:
|
|
|
60
64
|
|
|
61
65
|
- `10` tools de VTEX
|
|
62
66
|
- `11` tools de Google Ads
|
|
67
|
+
- `8` tools de Meta Ads
|
|
63
68
|
- `14` tools de Search Console
|
|
64
69
|
- `11` tools de GA4
|
|
65
70
|
- `1` tool/config de benchmarks
|
|
@@ -140,6 +145,7 @@ Dependiendo del módulo que quieras probar, el entorno puede requerir:
|
|
|
140
145
|
- credenciales de VTEX
|
|
141
146
|
- OAuth de Google para GA4 y Search Console
|
|
142
147
|
- credenciales de Google Ads
|
|
148
|
+
- credenciales de Meta Marketing API
|
|
143
149
|
|
|
144
150
|
## Configuración
|
|
145
151
|
|
|
@@ -156,6 +162,10 @@ Variables relevantes hoy:
|
|
|
156
162
|
- `GA4_PROPERTY_ID`
|
|
157
163
|
- `GOOGLE_ADS_DEVELOPER_TOKEN`
|
|
158
164
|
- `GOOGLE_ADS_LOGIN_CUSTOMER_ID`
|
|
165
|
+
- `META_APP_ID`
|
|
166
|
+
- `META_APP_SECRET`
|
|
167
|
+
- `META_ACCESS_TOKEN`
|
|
168
|
+
- `META_API_VERSION`
|
|
159
169
|
- `MCP_TRANSPORT`
|
|
160
170
|
- `PORT`
|
|
161
171
|
- `MCP_URL`
|
|
@@ -221,7 +231,11 @@ Uso vía `npx` después de publicar el paquete:
|
|
|
221
231
|
"GOOGLE_OAUTH_REFRESH_TOKEN": "your_google_oauth_refresh_token",
|
|
222
232
|
"GA4_PROPERTY_ID": "your_ga4_property_id",
|
|
223
233
|
"GOOGLE_ADS_DEVELOPER_TOKEN": "your_google_ads_developer_token",
|
|
224
|
-
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your_google_ads_login_customer_id"
|
|
234
|
+
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your_google_ads_login_customer_id",
|
|
235
|
+
"META_APP_ID": "your_meta_app_id",
|
|
236
|
+
"META_APP_SECRET": "your_meta_app_secret",
|
|
237
|
+
"META_ACCESS_TOKEN": "your_meta_access_token",
|
|
238
|
+
"META_API_VERSION": "v25.0"
|
|
225
239
|
}
|
|
226
240
|
}
|
|
227
241
|
}
|