Audiense Insights MCP Server

🏆 Сервер MCP Audiense Insights

Этот сервер, основанный на Model Context Protocol (MCP) , позволяет Claude или любому другому MCP-совместимому клиенту взаимодействовать с вашим аккаунтом Audiense Insights . Он извлекает маркетинговые идеи и анализ аудитории из отчетов Audiense, охватывая демографический, культурный, влиятельный и контентный анализ вовлеченности .

🚀 Предварительные условия

Перед использованием этого сервера убедитесь, что у вас есть:

• Node.js (v18 или выше)
• Приложение Клода для ПК
• Учетная запись Audiense Insights с учетными данными API
• Токен X/Twitter API Bearer Token (необязательно, для обогащенных данных влиятельных лиц)

⚙️ Настройка Claude Desktop

1. Откройте файл конфигурации для Claude Desktop:
   • MacOS:
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Окна:
     code %AppData%\Claude\claude_desktop_config.json
2. Добавьте или обновите следующую конфигурацию:
   "mcpServers": { "audiense-insights": { "command": "npx", "args": [ "-y", "mcp-audiense-insights" ], "env": { "AUDIENSE_CLIENT_ID": "your_client_id_here", "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", "TWITTER_BEARER_TOKEN": "your_token_here" } } }
3. Сохраните файл и перезапустите Claude Desktop.

🛠️ Доступные инструменты

📌 get-reports

Описание : Извлекает список отчетов Audiense Insights, принадлежащих аутентифицированному пользователю.

• Параметры : Нет
• Ответ :
  • Список отчетов в формате JSON.

📌 get-report-info

Описание : Извлекает подробную информацию о конкретном отчете разведки , включая:

• Статус
• Тип сегментации
• Размер аудитории
• Сегменты
• Ссылки доступа
• Параметры :
  • report_id(string) : идентификатор отчета разведки.
• Ответ :
  • Полные данные отчета в формате JSON.
  • Если отчет все еще обрабатывается, возвращается сообщение с указанием статуса ожидания.

📌 get-audience-insights

Описание : Извлекает обобщенные данные для заданной аудитории , включая:

• Демографические данные : пол, возраст, страна.
• Поведенческие черты : Активные часы, использование платформы.
• Психографика : Черты личности, интересы.
• Социально-экономические факторы : доход, уровень образования.
• Параметры :
  • audience_insights_id(string) : идентификатор информации об аудитории.
  • insights(массив строк, необязательно) : список конкретных названий идей для фильтрации.
• Ответ :
  • Аналитика отформатирована в виде структурированного текстового списка.

📌 get-baselines

Описание : Извлекает доступные базовые аудитории , опционально отфильтрованные по стране .

• Параметры :
  • country(строка, необязательно) : код страны ISO для фильтрации.
• Ответ :
  • Список базовых аудиторий в формате JSON.

📌 get-categories

Описание : Возвращает список доступных категорий близости , которые можно использовать при сравнении влиятельных лиц.

• Параметры : Нет
• Ответ :
  • Список категорий в формате JSON.

📌 compare-audience-influencers

Описание : Сравнивает влиятельных лиц заданной аудитории с базовой аудиторией . Базовая аудитория определяется следующим образом:

• Если одна страна представляет более 50% аудитории, то эта страна используется в качестве базовой линии.
• В противном случае используется глобальная базовая линия .
• Если выбран определенный сегмент , в качестве базового уровня используется вся аудитория.

Каждое сравнение влиятельных лиц включает в себя:

• Аффинити (%) – насколько хорошо влиятельный человек соответствует аудитории.
• Базовая близость (%) — близость влиятельного лица к базовой аудитории.
• Показатель уникальности — насколько влиятельный человек отличается от базового уровня.
• Параметры :
  • audience_influencers_id(string) : идентификатор влиятельных лиц аудитории.
  • baseline_audience_influencers_id(строка) : идентификатор влиятельных лиц базовой аудитории.
  • cursor(число, необязательно) : курсор пагинации.
  • count(число, необязательно) : количество элементов на странице (по умолчанию: 200).
  • bio_keyword(строка, необязательно) : Фильтрация влиятельных лиц по ключевому слову биографии .
  • entity_type(enum: person | brand , необязательно) : Фильтр по типу сущности.
  • followers_min(число, необязательно) : минимальное количество подписчиков.
  • followers_max(число, необязательно) : максимальное количество подписчиков.
  • categories(массив строк, необязательно) : фильтрация влиятельных лиц по категориям .
  • countries(массив строк, необязательно) : фильтрация влиятельных лиц по кодам стран ISO .
• Ответ :
  • Список влиятельных лиц с оценками сходства, сравнением с исходными данными и оценками уникальности в формате JSON.

📌 get-audience-content

Описание : Извлекает сведения о взаимодействии аудитории с контентом , включая:

• Понравившийся контент : самые популярные посты, домены, эмодзи, хэштеги, ссылки, медиа и облако слов.
• Общий контент : большая часть общего контента классифицирована схожим образом.
• Влиятельный контент : контент из влиятельных аккаунтов.

Каждая категория содержит:

• popularPost : Наиболее популярные публикации.
• topDomains : Наиболее упоминаемые домены.
• topEmojis : Наиболее используемые эмодзи.
• topHashtags : наиболее используемые хэштеги.
• topLinks : Наиболее распространенные ссылки.
• topMedia : общие медиа.
• wordcloud : Наиболее часто используемые слова.
• Параметры :
  • audience_content_id(строка) : идентификатор контента аудитории.
• Ответ :
  • Данные о взаимодействии с контентом в формате JSON.

📌 report-summary

Описание : Создает полную сводку отчета Audiense, включая:

• Метаданные отчета (название, тип сегментации)
• Полный размер аудитории
• Подробная информация о сегменте
• Основные сведения по каждому сегменту (биография, ключевые слова, демография, интересы)
• Наиболее влиятельные лица для каждого сегмента со сравнительными показателями
• Параметры :
  • report_id(string) : идентификатор отчета разведки, который необходимо обобщить.
• Ответ :
  • Полный отчет в формате JSON со структурированными данными по каждому сегменту
  • Для ожидающих отчетов: сообщение о состоянии, указывающее, что отчет все еще обрабатывается.
  • Для отчетов без сегментов: сообщение о том, что нет сегментов для анализа.

💡 Предопределенные подсказки

Этот сервер включает в себя предварительно настроенные подсказки

• audiense-demo : помогает анализировать отчеты Audiense в интерактивном режиме.
• segment-matching : подсказка для сопоставления и сравнения сегментов аудитории в отчетах Audiense, выявление сходств, уникальных черт и ключевых идей на основе демографических данных, интересов, влиятельных лиц и моделей взаимодействия.

Использование:

• Принимает аргумент reportName для поиска наиболее релевантного отчета.
• Если указан идентификатор, поиск выполняется по идентификатору отчета.

Вариант использования: структурированное руководство по анализу аудитории.

🛠️ Устранение неполадок

Инструменты не отображаются в Клоде

1. Проверьте журналы Claude Desktop:

2. Проверьте правильность настройки переменных среды.
3. Убедитесь, что абсолютный путь к index.js указан правильно.

Проблемы с аутентификацией

• Еще раз проверьте учетные данные OAuth.
• Убедитесь, что токен обновления все еще действителен.
• Убедитесь, что необходимые области API включены.

📜 Просмотр журналов

Чтобы проверить журналы сервера:

Для MacOS/Linux:

Для Windows:

🔐 Вопросы безопасности

• Сохраняйте учетные данные API в безопасности — никогда не публикуйте их в публичных репозиториях.
• Используйте переменные среды для управления конфиденциальными данными.

📄 Лицензия

Этот проект лицензирован по лицензии Apache 2.0. Подробнее см. в файле LICENSE.