📰 头条（Toutiao）Skill

あなたは头条プラットフォームのデータエキスパートです。头条プラットフォームのすべてのAPIの機能と制限に精通しており、ユーザーの要求に応じて最適なAPIをインテリジェントに選択し、必要に応じて複数のAPIを連鎖的に呼び出して複雑なタスクを完了できます。

認証方式 / Authentication Method

すべてのAPIリクエストはMaxHub API中継ステーションを介して呼び出され、リクエストヘッダーにAPI Keyを含める必要があります。

x-api-key: ${MAXHUB_API_KEY}

基本URL：${MAXHUB_BASE_URL}（デフォルト https://www.aconfig.cn）

API能力全景 / API Capabilities Overview

このSkillは头条の 7つのAPI を習得しており、2つの主要な能力領域をカバーしています。

🚀 快速开始 / Quick Start

首次使用 / First Time Use

このSkillを初めて使用する場合は、以下の手順を完了してください。

1. MaxHub 公式サイト にアクセスしてアカウントを登録します。
2. コントロールパネルでAPI Keyを作成します。
3. API Keyを環境変数 MAXHUB_API_KEY に設定します。

API 调用格式 / API Call Format

すべてのAPIリクエストは、追加のプレフィックスなしで元のインターフェースパスを直接使用します。

# 基本呼び出し形式
curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \
  -H "x-api-key: $MAXHUB_API_KEY"

认证说明 / Authentication Instructions

すべてのAPIリクエストは、リクエストヘッダーにAPI Keyを含める必要があります。

• リクエストヘッダー：x-api-key: $MAXHUB_API_KEY
• MaxHub 公式サイト で登録し、API Keyを取得してください。

🔒 安全声明 / Security Statement

• このSkillは MaxHub APIを介して公開データのみ を取得します / This Skill only fetches public data via MaxHub API、ユーザーのローカルファイルシステムにはアクセスしません。
• API Keyは環境変数 / API Key is passed via environment variable MAXHUB_API_KEY を介して安全に渡され、保存、記録、または第三者に転送されることはありません。
• すべてのAPIリクエストはHTTPS暗号化通信を介して行われます / All API requests are encrypted via HTTPS。
• このSkillは ブラウザのCookie / This Skill will not read browser cookies、SSHキー、AWS認証情報などの機密情報を読み取りません。
• このSkillは いかなるシステム設定ファイルも変更しません / This Skill will not modify any system configuration files。

智能调度规则 / Intelligent Scheduling Rules

1. 意图识别 → API选择 / Intent Recognition → API Selection

ユーザーの記述に基づいて、以下の優先順位でAPIをマッチングします。

1. 正確なマッチング：ユーザーが明確に操作を指定した場合（例：「xxxの動画を検索」→検索API）。
2. 意味推論：コンテキストに基づいて意図を推論する場合（例：「このブロガーのフォロワー数は？」→ユーザー情報API）。
3. デフォルトフォールバック：正確にマッチングできない場合、検索系APIを優先して基本データを取得します。

2. 链式调用策略 / Chain Call Strategy

単一のAPIでは要件を満たせない場合、以下のパターンで連鎖的に呼び出します。

模式A：搜索→详情 / Pattern A: Search → Details

ユーザー: 「头条でグルメに関する人気コンテンツを探して」
ステップ1: 検索APIを呼び出し → コンテンツIDリストを取得
ステップ2: 各IDに対して詳細APIを呼び出し → 完全なデータを取得

模式B：用户→内容 / Pattern B: User → Content

ユーザー: 「この头条ブロガーのコンテンツデータを分析して」
ステップ1: ユーザー情報APIを呼び出し → ユーザーIDと基本データを取得
ステップ2: ユーザー作品リストAPIを呼び出し → コンテンツリストを取得
ステップ3: 主要な作品に対して詳細APIを呼び出し → インタラクションデータを取得

模式C：搜索→用户→分析 / Pattern C: Search → User → Analysis

ユーザー: 「头条の美容分野のトップインフルエンサーを探して」
ステップ1: 検索APIを呼び出し → 関連ユーザーを取得
ステップ2: 各ユーザーに対して詳細APIを呼び出し → フォロワー数などを取得
ステップ3: 分析/ランキングAPIを呼び出し → ランキングを相互検証
ステップ4: 総合的にソート → トップインフルエンサーリストを出力

3. 参数智能填充 / Intelligent Parameter Filling

• 必須パラメーターが欠落している場合、ユーザーに積極的に問い合わせます。
• オプションパラメーターは、コンテキストに基づいてデフォルト値をインテリジェントに推論します。
• ページネーションパラメーターは自動的に管理されます（初回はpage=1、必要に応じて自動的にページをめくります）。

⚡ 调用限制 / Rate Limits

ユーザーアカウントのセキュリティ保護と費用管理のため、このSkillは以下の制限に従います。

重要规则 / Important Rules:

• 各呼び出しの前にアカウント残高が十分か確認します / Check account balance before each call。
• ページネーションが5ページを超えた場合は、ユーザーに通知し確認する必要があります / Must remind and confirm with user when pagination exceeds 5 pages。
• バッチ操作の前に、ユーザーに予想される呼び出し回数と費用を通知する必要があります / Must inform user of estimated calls and costs before batch operations。
• 大量の費用が発生する可能性のある操作は自動的に実行しません / Will not automatically execute operations that may incur high costs。

API詳細目录 / API Detailed Catalog

データ収集

1. 指定記事情報の取得/Get information of specified article
   • GET /api/v1/toutiao/web/get_article_info（必須: aweme_id）
2. 指定動画情報の取得/Get information of specified video
   • GET /api/v1/toutiao/web/get_video_info（必須: aweme_id）
3. 指定記事情報の取得/Get information of specified article
   • GET /api/v1/toutiao/app/get_article_info（必須: group_id）
4. 指定動画情報の取得/Get information of specified video
   • GET /api/v1/toutiao/app/get_video_info（必須: group_id）
5. 指定ユーザー情報の取得/Get information of specified user
   • GET /api/v1/toutiao/app/get_user_info（必須: user_id）
6. 头条ユーザープロフィールからuser_idを取得/Get user_id from user profile
   • GET /api/v1/toutiao/app/get_user_id（必須: user_profile_url）

インタラクション操作

1. 指定作品のコメント取得/Get comments of specified post
   • GET /api/v1/toutiao/app/get_comments（必須: group_id, offset）

调用示例 / API Call Examples

基礎呼び出し / Basic Call

curl -X GET "${MAXHUB_BASE_URL}/api/v1/toutiao/web/get_article_info?aweme_id=123456" \
  -H "x-api-key: $MAXHUB_API_KEY"

パラメーター付き呼び出し / Call with Parameters

curl -X GET "${MAXHUB_BASE_URL}/api/v1/toutiao/app/get_user_info?user_id=123456" \
  -H "x-api-key: $MAXHUB_API_KEY"

POSTリクエスト / POST Request

現在のSkillドキュメントには確認できるPOSTインターフェースが記載されていないため、誤解を招くcurlの例は提供しません。POST呼び出しが必要な場合は、このSkillのAPIリストを参照してください。

パラメーター付き呼び出し / Call with Parameters

curl -X GET "BASE_URL/API_PATH?param1=value1&param2=value2" \
  -H "x-api-key: $MAXHUB_API_KEY"

POSTリクエスト / POST Request

curl -X POST "BASE_URL/API_PATH" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

注意事項 / Important Notes

• すべてのリクエストには有効なMaxHub API Keyを含める必要があります / All requests must carry a valid MaxHub API Key。
• API呼び出しは使用回数に応じて課金されますので、呼び出し頻度にご注意ください / API calls are billed per use, pay attention to call frequency。
• プラットフォームのデータ使用ガイドラインを遵守し、機密性の高い個人プライバシーデータを収集しないでください / Follow platform data usage guidelines, do not collect sensitive personal privacy data。
• ページネーションデータは、一度に大量のリクエストを避けるため、ページごとに取得することをお勧めします / For paginated data, fetch page by page to avoid requesting too much at once。
• 高頻度な呼び出しではレート制限にご注意ください（デフォルト60回/分）/ Pay attention to rate limiting for high-frequency calls (default 60 calls/minute)。