Audiense Insights

官方

来自Audiense报告的市场洞察和受众分析，涵盖人口统计、文化、影响者及内容互动分析。

GitHub
19

你可以用 Audiense Insights MCP 做什么？

  • 列出您的 Audiense 报告 — 要求助手使用 get-reports 检索所有可用的洞察报告。
  • 总结完整报告 — 通过 report-summary 请求获取细分群体、核心洞察和影响者的结构化概览。
  • 获取受众人口统计与心理特征 — 使用 get-audience-insights 提取年龄、兴趣和性格等聚合特征。
  • 将影响者与基准进行对比 — 使用 compare-audience-influencers 识别针对特定受众的独特且高亲和力的影响者。
  • 分析内容互动 — 使用 get-audience-content 探索受众的热门帖子、话题标签、域名和共享链接。

文档

⚠️ 已弃用

🚫 此仓库不再维护。

Audiense Insights MCP 已迁移至远程模型。有关如何使用新的远程 MCP 的更多信息，请通过 support@audiense.com 联系我们。

🏆 Audiense Insights MCP 服务器

此服务器基于 模型上下文协议 (MCP)，允许 Claude 或任何其他兼容 MCP 的客户端与您的 Audiense Insights 账户进行交互。它从 Audiense 报告中提取 营销洞察和受众分析，涵盖 人口统计、文化、影响者及内容互动分析。

🚀 先决条件

在使用此服务器之前，请确保您具备：

  • Node.js（v18 或更高版本）
  • Claude 桌面应用
  • 带有 API 凭据的 Audiense Insights 账户
  • X/Twitter API Bearer Token （可选，用于丰富影响者数据）

⚙️ 配置 Claude 桌面

  1. 打开 Claude 桌面的配置文件：

    • MacOS： 
      code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    • Windows： 
      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. Save the file and restart Claude Desktop.

🛠️ Available Tools

📌 get-reports

Description: Retrieves the list of Audiense insights reports owned by the authenticated user.

  • Parameters: None
  • Response:
    • List of reports in JSON format.

📌 get-report-info

Description: Fetches detailed information about a specific intelligence report, including:

  • Status

  • Segmentation type

  • Audience size

  • Segments

  • Access links

  • Parameters:

    • report_id (string): The ID of the intelligence report.

  • Response:

    • Full report details in JSON format.
    • If the report is still processing, returns a message indicating the pending status.

📌 get-audience-insights

Description: Retrieves aggregated insights for a given audience, including:

  • Demographics: Gender, age, country.

  • Behavioral traits: Active hours, platform usage.

  • Psychographics: Personality traits, interests.

  • Socioeconomic factors: Income, education status.

  • Parameters:

    • audience_insights_id (string): The ID of the audience insights.
    • insights (array of strings, optional): List of specific insight names to filter.

  • Response:

    • Insights formatted as a structured text list.

📌 get-baselines

Description: Retrieves available baseline audiences, optionally filtered by country.

  • Parameters:

    • country (string, optional): ISO country code to filter by.

  • Response:

    • List of baseline audiences in JSON format.

📌 get-categories

Description: Retrieves the list of available affinity categories that can be used in influencer comparisons.

  • Parameters: None
  • Response:
    • List of categories in JSON format.

📌 compare-audience-influencers

Description: Compares influencers of a given audience with a baseline audience. The baseline is determined as follows:

  • If a single country represents more than 50% of the audience, that country is used as the baseline.
  • Otherwise, the global baseline is used.
  • If a specific segment is selected, the full audience is used as the baseline.

Each influencer comparison includes:

  • Affinity (%) – How well the influencer aligns with the audience.

  • Baseline Affinity (%) – The influencer’s affinity within the baseline audience.

  • Uniqueness Score – How distinct the influencer is compared to the baseline.

  • Parameters:

    • audience_influencers_id (string): ID of the audience influencers.
    • baseline_audience_influencers_id (string): ID of the baseline audience influencers.
    • cursor (number, optional): Pagination cursor.
    • count (number, optional): Number of items per page (default: 200).
    • bio_keyword (string, optional): Filter influencers by bio keyword.
    • entity_type (enum: person | brand, optional): Filter by entity type.
    • followers_min (number, optional): Minimum number of followers.
    • followers_max (number, optional): Maximum number of followers.
    • categories (array of strings, optional): Filter influencers by categories.
    • countries (array of strings, optional): Filter influencers by country ISO codes.

  • Response:

    • List of influencers with affinity scores, baseline comparison, and uniqueness scores in JSON format.

📌 get-audience-content

Description: Retrieves audience content engagement details, including:

  • Liked Content: Most popular posts, domains, emojis, hashtags, links, media, and a word cloud.
  • Shared Content: Most shared content categorized similarly.
  • Influential Content: Content from influential accounts.

Each category contains:

  • popularPost: Most engaged posts.

  • topDomains: Most mentioned domains.

  • topEmojis: Most used emojis.

  • topHashtags: Most used hashtags.

  • topLinks: Most shared links.

  • topMedia: Shared media.

  • wordcloud: Most frequently used words.

  • Parameters:

    • audience_content_id (string): The ID of the audience content.

  • Response:

    • Content engagement data in JSON format.

📌 report-summary

Description: Generates a comprehensive summary of an Audiense report, including:

  • Report metadata (title, segmentation type)

  • Full audience size

  • Detailed segment information

  • Top insights for each segment (bio keywords, demographics, interests)

  • Top influencers for each segment with comparison metrics

  • Parameters:

    • report_id (string): The ID of the intelligence report to summarize.

  • Response:

    • Complete report summary in JSON format with structured data for each segment
    • For pending reports: Status message indicating the report is still processing
    • For reports without segments: Message indicating there are no segments to analyze

💡 Predefined Prompts

This server includes a preconfigured prompts

  • audiense-demo: Helps analyze Audiense reports interactively.
  • segment-matching: A prompt to match and compare audience segments across Audiense reports, identifying similarities, unique traits, and key insights based on demographics, interests, influencers, and engagement patterns.

Usage:

  • Accepts a reportName argument to find the most relevant report.
  • If an ID is provided, it searches by report ID instead.

Use case: Structured guidance for audience analysis.

🛠️ Troubleshooting

Tools Not Appearing in Claude

  1. Check Claude Desktop logs:
tail -f ~/Library/Logs/Claude/mcp*.log
  1. Verify environment variables are set correctly.
  2. Ensure the absolute path to index.js is correct.

Authentication Issues

  • Double-check OAuth credentials.
  • Ensure the refresh token is still valid.
  • Verify that the required API scopes are enabled.

📜 Viewing Logs

To check server logs:

For MacOS/Linux:

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

For Windows:

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

🔐 安全注意事项

  • 确保 API 凭据安全——切勿在公共仓库中暴露它们。
  • 使用环境变量管理敏感数据。

📄 许可证

本项目基于 Apache 2.0 许可证授权。有关更多详细信息，请参阅 LICENSE 文件。