> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# Instagram 节点

使用 Anysite Instagram 节点在 n8n 工作流中提取 Instagram 数据

## 概述

Anysite Instagram 节点在您的 n8n 工作流中实现 Instagram 数据提取。获取用户资料、分析帖子、跟踪标签并监控互动指标，用于社交媒体分析。

## 节点配置

### 认证

  从下拉菜单中选择您的 Anysite API 凭证，或创建新凭证。

### 可用操作

#### 获取用户资料

提取详细的 Instagram 用户资料信息。

**参数：**
- **Username**（必填）：Instagram 用户名（不带 @）
- **Include Posts**：是否包含最近的帖子
- **Post Limit**：要包含的最近帖子数量（1-50）

**输出示例：**
```json
{
  "user": {
    "id": "instagram123",
    "username": "travel_blogger",
    "displayName": "Sarah's Adventures",
    "bio": "Travel enthusiast ✈️ | 50+ countries | Photography tips 📸",
    "followers": 125000,
    "following": 800,
    "posts": 1250,
    "isVerified": false,
    "isPrivate": false,
    "profileImageUrl": "https://instagram.com/profiles/...",
    "website": "https://sarahtravels.com",
    "category": "Travel"
  }
}
```

#### 获取用户帖子

从特定 Instagram 用户提取帖子。

**参数：**
- **Username**（必填）：Instagram 用户名
- **Post Count**：要检索的帖子数量（1-50）
- **Include Stories**：是否包含精选故事
- **Media Type**："all"、"photo"、"video"、"carousel"

**输出示例：**
```json
{
  "posts": [
    {
      "id": "post456",
      "shortcode": "ABC123def",
      "caption": "Amazing sunset in Bali! 🌅 #sunset #bali #travel",
      "mediaType": "photo",
      "mediaUrl": "https://instagram.com/images/...",
      "timestamp": "2024-08-26T18:30:00Z",
      "likes": 2800,
      "comments": 145,
      "hashtags": ["#sunset", "#bali", "#travel"],
      "mentions": ["@bali_tourism"],
      "location": {
        "name": "Tanah Lot, Bali",
        "id": "location789"
      }
    }
  ]
}
```

#### 搜索用户

按用户名或简介关键词搜索 Instagram 用户。

**参数：**
- **Query**（必填）：用于查找用户的搜索词
- **Category**：用户类别筛选（可选）
- **Verified Only**：仅返回认证账户
- **Limit**：返回的最大结果数（1-50）

**输出示例：**
```json
{
  "users": [
    {
      "id": "user789",
      "username": "food_critic_nyc",
      "displayName": "NYC Food Reviews",
      "followers": 85000,
      "isVerified": true,
      "category": "Food & Drink",
      "bio": "NYC's best restaurants 🍽️ | Food critic | DM for collabs"
    }
  ]
}
```

#### 分析帖子

获取特定 Instagram 帖子的详细分析。

**参数：**
- **Post URL**（必填）：Instagram 帖子 URL
- **Include Comments**：是否包含评论分析
- **Comment Limit**：要分析的评论数量

**输出示例：**
```json
{
  "post": {
    "id": "post123",
    "engagement": {
      "likes": 3200,
      "comments": 189,
      "saves": 245,
      "shares": 67,
      "engagementRate": 4.2
    },
    "audience": {
      "topCountries": ["US", "UK", "Canada"],
      "ageGroups": {
        "18-24": 35,
        "25-34": 45,
        "35-44": 20
      }
    },
    "performance": {
      "reach": 85000,
      "impressions": 125000,
      "profileVisits": 450
    }
  }
}
```

## 工作流示例

### 影响者研究

#### 寻找影响者

在您的细分市场中搜索具有高互动率的 Instagram 用户。

#### 分析资料

获取详细的资料信息，包括粉丝数、互动和内容主题。

#### 内容分析

分析最近的帖子以确保品牌一致性和真实互动。

#### 联系人数据库

建立包含联系信息和合作备注的合格影响者数据库。

**工作流示例：**
```json
{
  "nodes": [
    {
      "name": "Search Fashion Influencers",
      "type": "@horizondatawave/n8n-nodes-anysite.Instagram",
      "operation": "searchUsers",
      "parameters": {
        "query": "fashion blogger style influencer",
        "category": "Fashion",
        "limit": 50
      }
    },
    {
      "name": "Filter by Followers",
      "type": "n8n-nodes-base.filter",
      "parameters": {
        "conditions": [
          {
            "field": "followers",
            "operation": "greaterThan",
            "value": 10000
          },
          {
            "field": "followers",
            "operation": "lessThan",
            "value": 500000
          }
        ]
      }
    },
    {
      "name": "Get Recent Posts",
      "type": "@horizondatawave/n8n-nodes-anysite.Instagram",
      "operation": "getUserPosts",
      "parameters": {
        "username": "={{ $json.username }}",
        "postCount": 12,
        "mediaType": "all"
      }
    },
    {
      "name": "Calculate Engagement",
      "type": "n8n-nodes-base.function",
      "parameters": {
        "functionCode": `
          const avgLikes = items[0].json.posts.reduce((sum, post) => sum + post.likes, 0) / items[0].json.posts.length;
          const engagementRate = (avgLikes / items[0].json.followers) * 100;

          return [{
            json: {
              ...items[0].json,
              avgLikes,
              engagementRate
            }
          }];
        `
      }
    }
  ]
}
```

### 品牌监控

跟踪您品牌在 Instagram 上的提及：

1. **标签监控** - 跟踪品牌标签和活动
2. **提及检测** - 查找提及您品牌账号的帖子
3. **用户生成内容** - 发现发布您产品内容的客户
4. **竞争对手分析** - 监控竞争对手的社交媒体活动
5. **互动追踪** - 测量活动表现和触达

### 内容策略

基于竞争对手分析优化您的内容策略：

1. **顶级表现者** - 找到您细分市场中表现最好的帖子
2. **标签分析** - 识别热门和有效的标签
3. **发布模式** - 分析最佳发布时间和频率
4. **内容类型** - 确定哪种内容格式表现最好
5. **受众洞察** - 了解您的目标受众偏好

## 高级分析

### 互动分析

计算详细的互动指标：

```javascript
// 全面的互动计算
{
  "engagementMetrics": {
    "rate": "={{ (($json.likes + $json.comments) / $json.followers * 100).toFixed(2) }}%",
    "likesToCommentsRatio": "={{ ($json.likes / Math.max($json.comments, 1)).toFixed(1) }}",
    "avgLikesPerPost": "={{ ($json.totalLikes / $json.postCount).toFixed(0) }}",
    "viralityScore": "={{ ($json.likes > ($json.followers * 0.05) ? 'High' : 'Normal') }}"
  }
}
```

### 内容表现

分析哪种内容类型表现最好：

```json
{
  "name": "Analyze Content Types",
  "type": "n8n-nodes-base.function",
  "parameters": {
    "functionCode": `
      const posts = items.map(item => item.json);
      const byType = posts.reduce((acc, post) => {
        acc[post.mediaType] = acc[post.mediaType] || [];
        acc[post.mediaType].push(post);
        return acc;
      }, {});

      const analysis = Object.entries(byType).map(([type, typePosts]) => ({
        type,
        count: typePosts.length,
        avgLikes: typePosts.reduce((sum, p) => sum + p.likes, 0) / typePosts.length,
        avgComments: typePosts.reduce((sum, p) => sum + p.comments, 0) / typePosts.length
      }));

      return [{ json: { contentAnalysis: analysis } }];
    `
  }
}
```

## 标签研究

### 热门标签

在您的细分市场中找到热门标签：

```json
{
  "name": "Extract Hashtags",
  "type": "n8n-nodes-base.function",
  "parameters": {
    "functionCode": `
      const allHashtags = items.flatMap(item =>
        item.json.posts ? item.json.posts.flatMap(post => post.hashtags || []) : []
      );

      const hashtagCount = allHashtags.reduce((acc, tag) => {
        acc[tag] = (acc[tag] || 0) + 1;
        return acc;
      }, {});

      const trending = Object.entries(hashtagCount)
        .sort(([,a], [,b]) => b - a)
        .slice(0, 20)
        .map(([hashtag, count]) => ({ hashtag, count }));

      return [{ json: { trendingHashtags: trending } }];
    `
  }
}
```

### 标签表现

分析标签效果：

```javascript
// 标签表现指标
{
  "hashtagAnalysis": {
    "totalHashtags": "={{ $json.hashtags.length }}",
    "avgEngagement": "={{ ($json.likes + $json.comments) / Math.max($json.hashtags.length, 1) }}",
    "topHashtag": "={{ $json.hashtags[0] }}",
    "nicheTags": "={{ $json.hashtags.filter(tag => tag.includes('fashion') || tag.includes('style')).length }}"
  }
}
```

## 错误处理

### 常见问题

#### 私密账户

**错误：** `403 - Account is private`

**解决方案：**
- 在批量操作中跳过私密账户
- 专注于公开资料进行分析
- 维护可访问账户列表

#### 账户未找到

**错误：** `404 - User not found`

**解决方案：**
- 用户可能已更改用户名或删除账户
- 定期更新您的用户数据库
- 在工作流中优雅地处理缺失用户

#### 达到速率限制

**错误：** `429 - Too many requests`

**解决方案：**
- 在请求之间添加延迟（推荐：2-3 秒）
- 实现指数退避
- 监控您的 API 使用情况并相应计划

### 健壮的请求处理

```json
{
  "name": "Instagram with Retry",
  "type": "@horizondatawave/n8n-nodes-anysite.Instagram",
  "continueOnFail": true,
  "retryOnFail": true,
  "maxTries": 3,
  "waitBetweenTries": 4000,
  "parameters": {
    "operation": "getUserProfile",
    "username": "{{ $json.username }}"
  }
}
```

## 数据处理

### 资料评分

基于多个因素对影响者资料评分：

```javascript
// 影响者评分算法
{
  "influencerScore": {
    "followersScore": "={{ Math.min($json.followers / 10000, 10) }}",
    "engagementScore": "={{ ($json.engagementRate > 3 ? 10 : $json.engagementRate * 3.33) }}",
    "contentScore": "={{ ($json.posts.length > 100 ? 10 : $json.posts.length / 10) }}",
    "verificationBonus": "={{ $json.isVerified ? 2 : 0 }}",
    "totalScore": "={{ ($json.followersScore + $json.engagementScore + $json.contentScore + $json.verificationBonus) / 3.2 }}"
  }
}
```

### 受众分析

分析粉丝人口统计和兴趣：

```json
{
  "name": "Analyze Audience",
  "type": "n8n-nodes-base.openAi",
  "parameters": {
    "operation": "analyze",
    "prompt": "Based on this Instagram profile bio and recent posts, what audience demographics and interests would this account attract? Bio: {{ $json.bio }}, Recent posts: {{ $json.recentPosts.map(p => p.caption).join(' | ') }}"
  }
}
```

## 集成示例

### CRM 集成

将合格的影响者添加到您的 CRM：

```json
{
  "name": "Add to CRM",
  "type": "n8n-nodes-base.hubspot",
  "parameters": {
    "operation": "create",
    "resource": "contact",
    "data": {
      "firstname": "={{ $json.displayName.split(' ')[0] }}",
      "lastname": "={{ $json.displayName.split(' ').slice(1).join(' ') }}",
      "instagram_handle": "={{ $json.username }}",
      "follower_count": "={{ $json.followers }}",
      "engagement_rate": "={{ $json.engagementRate }}",
      "category": "={{ $json.category }}"
    }
  }
}
```

### 内容日历

基于竞争对手分析构建内容日历：

```json
{
  "name": "Generate Content Ideas",
  "type": "n8n-nodes-base.openAi",
  "parameters": {
    "operation": "generate",
    "prompt": "Based on these high-performing Instagram posts, generate 5 content ideas for our brand: {{ JSON.stringify($json.topPosts) }}"
  }
}
```

### 报告生成

创建 Instagram 分析报告：

```json
{
  "name": "Generate Report",
  "type": "n8n-nodes-base.googleDocs",
  "parameters": {
    "operation": "create",
    "title": "Instagram Analysis Report - {{ new Date().toLocaleDateString() }}",
    "content": `
      # Instagram Analysis Report

      ## Top Performers
      {{ $json.topInfluencers.map(inf => \`- \${inf.username}: \${inf.followers} followers, \${inf.engagementRate}% engagement\`).join('\\n') }}

      ## Trending Hashtags
      {{ $json.trendingHashtags.map(tag => \`- \${tag.hashtag} (\${tag.count} uses)\`).join('\\n') }}

      ## Recommendations
      {{ $json.recommendations }}
    `
  }
}
```

## 性能优化

### 批量操作

高效处理多个账户：

```json
{
  "name": "Batch Process Users",
  "type": "n8n-nodes-base.splitInBatches",
  "parameters": {
    "batchSize": 10,
    "options": {
      "reset": false
    }
  }
}
```

### 数据缓存

缓存资料数据以减少 API 调用：

```javascript
// 简单的缓存机制
{
  "name": "Cache Profile Data",
  "type": "n8n-nodes-base.function",
  "parameters": {
    "functionCode": `
      const cacheKey = \`profile_\${items[0].json.username}\`;
      const cached = $('Cache').last()?.json?.[cacheKey];

      if (cached && Date.now() - cached.timestamp < 3600000) { // 1 小时缓存
        return [{ json: cached.data }];
      }

      // 存储到缓存供下次使用
      const cacheData = {
        [cacheKey]: {
          data: items[0].json,
          timestamp: Date.now()
        }
      };

      return [
        { json: items[0].json },
        { json: cacheData, pairedItem: { item: 0, input: 0 } }
      ];
    `
  }
}
```

## 最佳实践

### 道德数据收集

- 尊重用户隐私和 Instagram 的服务条款
- 仅收集公开可用的数据
- 实施适当的速率限制
- 安全存储数据并在不再需要时删除

### 性能技巧

- 对大型数据集使用批处理
- 为频繁访问的资料实施缓存
- 在请求之间添加适当的延迟
- 监控您的 API 使用情况以保持在限制范围内

## 后续步骤

- [LinkedIn 节点](/docs/n8n-nodes/linkedin-node?lang=zh) - LinkedIn 数据提取
- [Twitter 节点](/docs/n8n-nodes/twitter-node?lang=zh) - Twitter/X 监控
- [Reddit 节点](/docs/n8n-nodes/reddit-node?lang=zh) - Reddit 讨论分析
- [工作流](/docs/n8n-nodes/workflows?lang=zh) - 预构建的工作流模板