Social Media Analyzer

ソーシャルメディアコンテンツとエンゲージメントを分析するスキルです。複数のプラットフォームからデータを収集し、パフォーマンスメトリクスを計算し、アクションアイテムを生成します。

機能

• コンテンツ分析: テキスト、画像、動画コンテンツを分析
• エンゲージメント追跡: いいね、コメント、シェアを監視
• トレンド検出: 人気トピックとハッシュタグを特定
• センチメント分析: コメントと反応からユーザーの感情を測定
• 競合分析: 競合他社のパフォーマンスを比較
• レポート生成: 詳細な分析レポートを作成

使用方法

基本的な使用例

const analyzer = new SocialMediaAnalyzer({
  apiKeys: {
    twitter: 'your-api-key',
    instagram: 'your-api-key',
    facebook: 'your-api-key'
  }
});

const results = await analyzer.analyze({
  platforms: ['twitter', 'instagram'],
  timeframe: '7d',
  includeCompetitors: true
});

パラメータ

• platforms: 分析対象のプラットフォーム配列 (必須)
• timeframe: 分析期間 (デフォルト: '7d')
• includeCompetitors: 競合分析を含めるか (デフォルト: false)
• metrics: 計算するメトリクスの配列 (デフォルト: すべて)

戻り値

{
  summary: {
    totalPosts: number,
    totalEngagement: number,
    averageEngagementRate: number,
    topPost: object
  },
  platforms: {
    [platform]: {
      posts: array,
      metrics: object,
      trends: array
    }
  },
  sentiment: {
    positive: number,
    neutral: number,
    negative: number
  },
  recommendations: array
}

インストール

npm install @agent-skills/social-media-analyzer

設定

環境変数でAPI認証情報を設定してください:

TWITTER_API_KEY=your-key
INSTAGRAM_API_KEY=your-key
FACEBOOK_API_KEY=your-key

API リファレンス

analyze(options)

ソーシャルメディアデータを分析します。

パラメータ:

• options (object): 分析オプション

戻り値: Promise<AnalysisResult>

getMetrics(platform, postId)

特定の投稿のメトリクスを取得します。

パラメータ:

• platform (string): ソーシャルメディアプラットフォーム
• postId (string): 投稿ID

戻り値: Promise<Metrics>

detectTrends(platform, timeframe)

プラットフォーム上のトレンドを検出します。

パラメータ:

• platform (string): ソーシャルメディアプラットフォーム
• timeframe (string): 分析期間

戻り値: Promise<Trend[]>

analyzeSentiment(content)

コンテンツのセンチメントを分析します。

パラメータ:

• content (string): 分析するテキストコンテンツ

戻り値: Promise<SentimentResult>

例

週間パフォーマンスレポート

const report = await analyzer.analyze({
  platforms: ['twitter', 'instagram', 'facebook'],
  timeframe: '7d',
  metrics: ['engagement', 'reach', 'sentiment']
});

console.log(`総エンゲージメント: ${report.summary.totalEngagement}`);
console.log(`エンゲージメント率: ${report.summary.averageEngagementRate}%`);
console.log(`トップ投稿: ${report.summary.topPost.content}`);

トレンド監視

const trends = await analyzer.detectTrends('twitter', '24h');
trends.forEach(trend => {
  console.log(`#${trend.hashtag}: ${trend.volume} 投稿`);
});

セッションメント分析

const sentiment = await analyzer.analyzeSentiment(
  'このスキルはとても便利です!'
);
console.log(`ポジティブスコア: ${sentiment.positive}`);

トラブルシューティング

API キーが見つからない

環境変数が正しく設定されているか確認してください。

レート制限エラー

リクエスト間に遅延を追加するか、バッチ処理を使用してください。

不正確なセンチメント分析

多言語コンテンツの場合は言語を明示的に指定してください。

ベストプラクティス

1. 定期実行: スケジュール設定して定期的に分析を実行
2. 複数プラットフォーム: より包括的な分析のために複数のプラットフォームを含める
3. 履歴データ: 時系列でのパフォーマンス変化を追跡
4. アクション: 推奨事項に基づいてコンテンツ戦略を調整

ライセンス

MIT

サポート

質問やバグ報告については、GitHub Issues にお願いします。