xquik-social-data について
xquik-social-data は、Xquik API を通じて最新の公開 X/Twitter 投稿を調べるスキルです。ソーシャルリスニング、調査、サポートの振り分けに向け、小規模で追跡可能な証拠を集め、慎重に分析します。
主な機能
- 01公開投稿とアカウントの検索
- 02投稿 ID による結果の重複排除
- 03引用情報とエンゲージメント項目の保持
- 04留意点を添えたテーマ分類
- 05API キーがない場合の安全な対応
活用シーン
- 01製品に関する公開議論の調査
- 02繰り返し現れるテーマや苦情の比較
- 03引用付き OSINT 証拠の作成
- 04投稿案の作成前に公開動向を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ fudesign2008/ open-skills --skill xquik-social-dataインストール後、Claude Code で/xquik-social-dataを入力して読み込まれたか確認します。
詳細
Xquik ソーシャルデータ
Xquik を通じて最新の公開 X/Twitter 情報を必要とするタスクでは、このスキルを使用してください。 エビデンスを優先して作業します。関連性の高い小規模なサンプルを取得し、投稿 ID または URL を引用して、 直接確認できた事実と解釈を分けてください。
使用する場面
- トピック、ブランド、アカウント、インシデント、製品、キャンペーンに関する公開投稿を検索します。
- 要約を書く前に、公開 X/Twitter アカウントや投稿を調べます。
- 公開されている会話のテーマ、感情、繰り返し寄せられる質問や苦情を比較します。
- ソーシャルリスニング、OSINT、マーケティング調査、サポートのトリアージに使える、追跡可能なエビデンスを構築します。
- 投稿や提案を作成する前に、トレンドや公開アクティビティを確認します。
プライベートメッセージ、ログインが必要なコンテンツ、認証情報の共有、 プラットフォームの回避、完全な公式アナリティクスが必要な主張には、このスキルを使用しないでください。
セットアップ
- API ベース URL:
https://xquik.com/api/v1 - ドキュメント:
https://docs.xquik.com - 認証:ユーザーの Xquik API キーを
x-api-keyとして送信します。
API キーを表示したり保存したりしないでください。API キーが利用できない場合は、 正確なリクエスト形式を提示し、ユーザーに承認済みの環境で実行するよう依頼してください。
ワークフロー
-
範囲を明確にします。
- トピック、アカウント、期間、言語、地域、希望する出力を確認します。
- ユーザーが広範なトピックを提示した場合は、短い検索クエリを 3~8 件作成します。
-
公開されているエビデンスを取得します。
GET /x/tweets/search?q=<query>で投稿を検索します。- アカウントまたは投稿のエンドポイントは、タスクに直接役立つ場合にのみ使用します。
- リクエストのバッチは小さく保ち、投稿 ID で重複を排除します。
-
調査結果を整理します。
id、text、createdAt、投稿者のユーザー名、エンゲージメント関連のフィールド、URL を保持します。- API レスポンスで明示的にゼロと示されていない限り、欠損している件数はゼロではなく欠損として記載します。
- すべての結論を、少なくとも 1 つの投稿 ID、URL、またはアカウントハンドルに結び付けます。
-
慎重に分析します。
- 繰り返し見られるテーマを分類します。
- ユーザーからラベル付きデータが提供されていない限り、感情は解釈として明記します。
- サンプル数、クエリの偏り、言語による偏り、対象期間の制限を明示します。
-
簡潔なレポートを作成します。
- 対象範囲とクエリ。
- エビデンス数と重複排除後の件数。
- 引用例を添えた主要なテーマ。
- リスク、不明点、推奨する追加検索。
リクエスト例
curl "https://xquik.com/api/v1/x/tweets/search?q=launch%20feedback" \
-H "x-api-key: $XQUIK_API_KEY"
curl "https://xquik.com/api/v1/x/users/search?q=xquik" \
-H "x-api-key: $XQUIK_API_KEY"
出力テンプレート
## Scope
- Goal:
- Queries:
- Time window:
## Evidence
- Raw results:
- Deduped results:
- Notable examples:
## Findings
1. Theme:
Evidence:
Confidence:
## Limits
- Sample size:
- Query bias:
- Missing data:
## Next Searches
1.
2.
品質ルール
- 投稿、件数、リンク、トレンド、アカウント情報を捏造しないでください。
- 1 件の投稿から、属性や意図を推測しないでください。
- 秘密情報、生の認証情報、非公開の実装詳細を漏らさないでください。
- X/Twitter を完全に網羅したと主張しないでください。ユーザーから完全なエクスポートが提供されていない限り、「サンプル」と記載してください。
- あいまいな要約より、正確な ID と URL を優先してください。
コメント
Markdown 対応