notion

Store and manage influencer data in Notion database

$ Installieren

git clone https://github.com/vm0-ai/vm0-cookbooks /tmp/vm0-cookbooks && cp -r /tmp/vm0-cookbooks/206-tiktok-influencer/claude-tiktok-influencer/skills/notion ~/.claude/skills/vm0-cookbooks

// tip: Run this command in your terminal to install the skill


name: notion description: Store and manage influencer data in Notion database

Notion Skill

Add, update, and query influencer data in a Notion database.

When to Use

Use this skill when you need to:

  • Store new influencer data in Notion
  • Update influencer records with analysis results
  • Query existing data from the database

Setup Requirements

  1. Create a Notion Integration: https://www.notion.so/my-integrations
  2. Copy the Integration Token (starts with ntn_ or secret_)
  3. Create a database in Notion with the required columns
  4. Share the database with your integration (click "..." → "Add connections")

Database Structure

The Notion database should have these properties:

PropertyTypeDescription
Profile IDTitleUnique TikTok profile ID
UsernameTextTikTok username (e.g., @username)
URLURLLink to TikTok profile
DescriptionTextProfile description
FollowersNumberFollower count
CollaborationSelectOptions: "Highly Relevant", "Not Relevant"
AnalysisText50-word analysis of relevance

How to Use

Add a New Influencer

$CLAUDE_CONFIG_DIR/skills/notion/scripts/notion-add.sh "database_id" "profile_id" "username" "url" "description" "followers"

Parameters:

  • database_id: The Notion database ID (from the URL)
  • profile_id: Unique TikTok profile ID
  • username: TikTok username (e.g., "@fitness_guru")
  • url: Full TikTok profile URL
  • description: Profile description text
  • followers: Follower count (number)

Returns: The created page ID (save this for updates)

Example:

$CLAUDE_CONFIG_DIR/skills/notion/scripts/notion-add.sh "abc123def" "12345" "@fitness_guru" "https://tiktok.com/@fitness_guru" "Personal trainer sharing workout tips" "150000"
# Output: page_id=xyz789

Update with Analysis

$CLAUDE_CONFIG_DIR/skills/notion/scripts/notion-update.sh "page_id" "collaboration" "analysis"

Parameters:

  • page_id: The page ID returned from notion-add.sh
  • collaboration: Either "Highly Relevant" or "Not Relevant"
  • analysis: 50-word analysis explaining the classification

Example:

$CLAUDE_CONFIG_DIR/skills/notion/scripts/notion-update.sh "xyz789" "Highly Relevant" "Strong alignment with fitness industry. 150K engaged followers interested in workout content. Profile description mentions personal training which matches client needs. Content style professional and brand-safe. Excellent candidate for fitness brand collaboration."

Query Database

$CLAUDE_CONFIG_DIR/skills/notion/scripts/notion-query.sh "database_id"

Parameters:

  • database_id: The Notion database ID

Returns: JSON with all entries in the database

Example:

$CLAUDE_CONFIG_DIR/skills/notion/scripts/notion-query.sh "abc123def"

Environment Variables

  • NOTION_API_KEY: Required. Your Notion Integration Token.

Error Handling

ErrorCauseSolution
401 UnauthorizedInvalid API keyVerify NOTION_API_KEY is correct
404 Not FoundDatabase not sharedShare database with your integration
400 Bad RequestInvalid property formatCheck database schema matches expected structure