Сервер MCP Audiense Insights

🏆 Сервер 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

Откройте файл конфигурации для Claude Desktop:
- MacOS:
  code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Окна:
  code %AppData%\Claude\claude_desktop_config.json
Добавьте или обновите следующую конфигурацию:
"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" } } }
Сохраните файл и перезапустите 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 для поиска наиболее релевантного отчета.
Если указан идентификатор, поиск выполняется по идентификатору отчета.

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

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

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

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

tail -f ~/Library/Logs/Claude/mcp*.log

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

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

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

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

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

Для MacOS/Linux:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Для Windows:

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

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

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

📄 Лицензия

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

Audiense Insights MCP Server