Connecting Audiense Data to AI Using Claude

This guide walks you through integrating Claude with your Audiense API to enhance audience intelligence analysis. By following these steps, you’ll learn how to install and set up Claude on macOS, connect it with Audiense’s API, and leverage pre-configured prompts to uncover audience insights effortlessly.

Key Steps in This Guide:

1. Download and Install the Claude Desktop App (optional upgrade to Claude Pro for premium features)
2. Setting Up and Connecting Your Audiense Account API for Claude (optional X API connection for enriched data)
3. Using Claude for Audience Intelligence Analysis

Whether you're analyzing audience segments, affinities, or trends, this guide ensures you maximize Claude AI’s capabilities for data-driven decision-making.

Step 1:

Download and Install the Claude Desktop App (optional upgrade to Claude Pro)

• Visit the Official Claude Website:

  • Open your preferred web browser and go to the official Claude website https://claude.ai/download to download the app. 

• Choose the macOS Version:

  • Once on the download page, look for the macOS version of the Claude Desktop app.
  • Click on the Download for macOS button to begin the download.

• Locate the Downloaded File:

  • After the download is complete, go to your Downloads folder (or wherever your browser saves files) and find the Claude Desktop app installer file (Claude.dmg).

Install the Claude Desktop App

1. Launch the Installer:

• Double-click the downloaded Claude Desktop app installer file to open it.

2. Follow the Installation Instructions:

• The installer will launch with an on-screen guide. You can accept the default installation settings by clicking Continue and then install.
• During installation, you may be prompted to enter your Mac's administrator password to authorize the process.

3. Complete Installation:

• Once installation is complete, you’ll see a confirmation message indicating that the Claude Desktop app has been successfully installed on your Mac.
• You can now find Claude in your Applications folder or search for it via Spotlight + add it to your Doc.

Upgrade to the Claude Paid Version (Optional, but Recommended)

While the free version of Claude is available, Claude Pro unlocks premium features for a better experience. To upgrade:

1. Launch the Claude Desktop App:

   • After installation, open Claude from the Applications folder or from the Dock.

2. Sign Up or Log In:

   • If you are a first-time user, create a Claude account, or log in if you already have one.

3. Upgrade to the Paid Version:

   • Once logged in, you’ll be prompted to upgrade to the Paid Version if you’re still using the free version.
   • Alternatively, go to the Settings or Account menu (usually located in the top left corner or under your profile) and select the Upgrade to Paid Version or Get Premium Access option.

4. Select Your Plan:

   • Choose the Monthly or Annual subscription plan based on your preference.
   • Enter your payment details and confirm the purchase.

5. Activate Paid Version:

   • After the payment is processed, your Claude account will be upgraded to the paid version, unlocking all premium features.

Once upgraded, Claude Pro provides access to advanced AI capabilities, enhancing your audience intelligence workflow.

Step 2:

Setting Up and Connecting Audiense API to Claude (optional X API connection)

This process typically takes less than five minutes and requires no technical knowledge beyond basic navigation of your Mac’s interface. The installer automatically handles all the complex configuration tasks that would otherwise require command-line expertise.

Obtain API Credentials:

For Audiense Insights Unlimited Plans 

• Before proceeding, ensure that you have Audiense API credentials. These are necessary for connecting Claude to the Audiense API.
• API Keys include 2 codes: (1) Client ID and (2) Client Secret 
• Speak to your Account Manager or CSM to obtain these, alternatively contact help@audiense.com
• Please note, you may want an X API key, as this is not a requirement, but it does provide enriched data, especially for Influencers. 

X API Token (Optional, but Recommended for Enriched Data)

• Connecting an X API token is not required but provides enhanced influencer and audience insights.

• Without it, you can still retrieve influencer and audience IDs, but not their enriched profile data.

• To obtain an X API token, follow the steps in the section "How to Obtain an X API" below.

Download and Install Node.js:

1. Open your web browser and go to the official Node.js website.
2. On the homepage, you may see two download versions. Click on the button labeled “LTS” (Long Term Support). This version is more stable and recommended for most users
   
3. The website will automatically detect your macOS and suggest the appropriate download. Click on
   “macOS Installer” to download the .pkg file.
4. Once the file is downloaded, locate and double-click the .pkg file to begin installation.

Follow the Installation Instructions:

• The installer will guide you through the process. You can generally accept all the default settings by clicking Continue and then Install.
• During installation, you may be prompted to enter your Mac password to authorize the installation.

Finish Installation:

• After installation is complete, you'll see a confirmation screen indicating that Node.js is successfully installed on your Mac

Verify Installation of Node.js: Open Terminal:

• After installing Node.js, it’s important to verify that everything is working correctly. While this does require opening Terminal (which might be unfamiliar to non-technical users), the process involves just a simple command

• Open Terminal (you can find it by searching for “Terminal” in Spotlight, which you access by pressing Command+Space bar).

Check Node.js Installation:

• Type node -v and press Enter. This will display the installed version of Node.js. Make sure you leave a space between the word node and –v

• On a Mac keyboard, the minus sign (–) used in the -v command is typically the regular hyphen key, located directly to the right of the 0 (zero) key on the top row of the keyboard. You do not need to press any additional modifier key to get the minus symbol. Just press the key as is.

Enter Audiense MCP Code:

1. Open Terminal on your Mac.
2. Run the following command - Copy/Paste:
   npx -y @smithery/cli@latest install @AudienseCo/mcp-audiense-insights --client claude
3. Follow the on-screen instructions in Terminal.
4. When prompted with (Y/n), be mindful of the capitalization:
   1. Press Y for Yes (uppercase).
   2. Press n for No (lowercase).

Authenticate and connect your Account API codes:

• When prompted, enter the API tokens for your Audiense account and any required information to authenticate your Audiense API credentials.
• It will ask for one by one, starting with the Client ID and then Client Secret.

Enter API Token for X (Optional, but Recommended):

In order to get more enriched data, including influencers and members, an X API connection is recommended. Without it, you will only have access to member and influencer IDs via the Audiense API, but not their enriched profile data. Connecting the X API allows you to retrieve detailed profiles, making your analysis even more comprehensive.

1. During the setup process, you will be prompted for an X token.

2. If you have an X API token, paste it when prompted in Terminal.

3. If you don’t have one, you can skip this step and proceed with the basic Audiense API connection, or check the section below about obtaining your X API Bearer token.

Complete the Setup:

• Follow any additional instructions in Terminal to finalize the setup when connecting your Audiense account API to Claude.

Choose following steps

1. Obtain an X API token - optional, but recommended (come back to the above steps once you have it)
2. Jump to Using Claude for Audience Intelligence Analysis (once your Audiense API is connected)

 

How to obtain an X (formerly Twitter) API:

How to Create a Developer Account & Obtain API Keys for X

1. Create a Developer Account

• Go to the Twitter Developer Portal and sign in with the brand's or agency's X account.
• If not already enrolled, apply for a Developer Account by describing how the API will be used (e.g., data analysis, sentiment tracking).

2. Create a Project & Developer App

• Once approved, log in to the Developer Portal.
• Navigate to Projects & Apps → Create Project to set up a new project.
• Within the project, create an App that will be used to access the API.
• Fill in details like App Name and Use Case, which help X evaluate API usage.

3. Obtain API Keys & Tokens

After setting up the project and app, X will provide the following credentials:

• API Key & API Secret Key – Used for authentication when making requests.
• Access Token & Access Token Secret – Allow access to the account’s data.
• Bearer Token (Needed for Claude AI Integration) – A pre-authenticated key for accessing public X data without requiring full OAuth authentication.

• Use the Bearer Token to integrate with Claude.

4. Configure Access Levels

• Choose between Essential Access (basic public data) or Elevated Access (advanced API usage, like posting tweets).
• If advanced features are needed, request Elevated Access and explain how the API will be used. 

• For Claude AI, Essential Access is typically sufficient.

Ensure compliance - Review the Developer Agreement & Policy to avoid violations that may lead to revoked access.

 

Step 3:

Using Claude for Audience Intelligence Analysis

Open your Claude Desktop app 

• Sign into Claude, if you haven't already
• Ensure you're logged into your Claude Pro account to access premium features (better experience).

• Click on the hammer icon to see the tools that come with the Filesystem MCP Server:

 

 

• To streamline your analysis, use one of the pre-set prompts designed for Audience Intelligence by clicking on the icon resembling a switch or toggle referred to as the Prompt Manager. This feature lets you create, organize, and quickly access custom prompts within the Claude AI interface.
  • Audience Segmentation – Identify key audience segments based on shared characteristics.
  • Affinity Analysis – Uncover the brands, influencers, and interests most relevant to your audience.
  • Content Strategy – Generate insights on the content formats and topics that resonate with your target audience.
    
    

 

• Select one of the prompts, and follow the steps to include your report name
  
  

 

• As an example, if you select segment-matching, this will allow you to compare two reports - just type the names of your reports (example here for Disney + and Netflix)
  
  

 

• After submitting, Claude will ask if the reports it found are correct - simply confirm or correct them in the chat by specifying the report names for a more accurate match.
  
  

 

• Click the upwards arrow and hit Allow for this chat 
  
  

 

 
• What to Expect: Results will open up in a window like this within the App.
  
  

 

• You can copy, download or publish to get the URL link
  
  

 

• Click on the link, or paste it in a new window
  
  

 

• You may see a message - just click 'Show Content' to proceed.
  
  

 

• You can ask Claude any questions about the report data in the chat, once you've reviewed the results. This could include Influencer comparisons, content suggestions that would resonate with any of the clusters, or any other information you wish it to analyze.
  
  

 

• Connecting your X API Bearer Token enables enriched influencer data, enhancing the depth of your analysis depending on your queries.