Publicidad de Amazon
API de tiendas conectadas de Amazon Ads MCP
Lista las tiendas conectadas a su cuenta de Amazon Ads para que pueda elegir la cuenta para utilizar para la gestión de campañas.
Prompts y casos de uso de API de tiendas conectadas de Amazon Ads
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Compras de publicidad conectada
Prompt: Lista las tiendas Amazon Ads conectadas a mi Nexscope cuenta para que pueda elegir cuál usar. No exponga las credenciales.
2. Elija una tienda conectada para un mercado
Prompt: Lista las tiendas Amazon Ads conectadas a mi Nexscope cuenta para que pueda elegir cuál usar. No exponga las credenciales. Grupo regresó tiendas por país y región, mostrando identificadores de cuenta y perfil para poder elegir la tienda correcta. No asuma el acceso a las tiendas ausentes de este inventario de conexión.
3. Encontrar el tipo de cuenta de publicidad apropiada
Prompt: Lista mis tiendas conectadas Amazon Ads y lista corta aquellas cuyo tipo de cuenta devuelto coincide [seller, vendor or agency]. Mostrar el nombre de la cuenta, identificador del anunciante, perfil y lugar de mercado para cada partido. Este es un filtro en el inventario devuelto, no una nueva autorización de cuenta o una garantía de que cada operación de publicidad está disponible.
Qué debes proporcionar
Usa tu autentificado Nexscope cuenta para ver sus tiendas conectadas. No se necesita identificador de la tienda para este listado.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_data_amazon_ads_authorized_storeshttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "data-amazon-ads-authorized-stores-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_authorized_stores",
"arguments": {}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Argumentos
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | El número de sitios autorizados devueltos. |
stores[] | array | opcional | Cuenta × registro de autorización del sitio. |
profileId | number | opcional | El perfil ID utilizado por operaciones de anuncios de aguas abajo. |
accountInfoId | string | opcional | Identificador de entidad anunciante. |
accountInfoName | string | opcional | Store/advertiser nombre. |
accountType | string | opcional | `seller`, `vendor` o `agency`. |
countryCode | string | opcional | Código del país del sitio. |
marketplaceStringId | string | opcional | Mercado de Amazon ID。 |
region | string | opcional | `NA`, `EU` o `FE`. |
authRecordId | number | opcional | Registro de autorización ID. |
accountName | string | opcional | El nombre de la cuenta se establece durante la autorización. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Que Amazon ¿Puedo acceder a las tiendas de anuncios?
Explicación ilustrativa de la respuesta
La respuesta ilustrativa enumera una autorizada US tienda, “Example US Cuenta de anuncios”, en la región de América del Norte. Seleccione una tienda que posee antes de solicitar sus datos de publicidad.
Sobre esta muestra: Ejemplo meramente ilustrativo: los nombres, identificadores y cifras son ficticios y no se hizo una llamada real. Tus resultados dependen de tu cuenta, las entradas y los datos disponibles.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "data-amazon-ads-authorized-stores-example",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_authorized_stores",
"arguments": {}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "data-amazon-ads-authorized-stores-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"stores\":[{\"profileId\":123456789,\"accountInfoName\":\"Example US Ads account\",\"countryCode\":\"US\",\"region\":\"NA\"}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"stores": [
{
"profileId": 123456789,
"accountInfoName": "Example US Ads account",
"countryCode": "US",
"region": "NA"
}
]
}
},
"isError": false
}
}