🏆 Сервер 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: : Фильтр по типу сущности.

  • 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.