Add Xquik social data skill (#97)
Co-authored-by: kriptoburak <kriptoburak@users.noreply.github.com>
This commit is contained in:
Burak Bayırandkriptoburak authored and GitHub committed
1 parent
a984f2a7aa
commit
89d0e4c8b3
2 files changed
+83
-1
No files matched your search
+1
-1
@@ -1 +1 @@
|
||||
{"hands":[{"id":"analytics","name":"Analytics Hand","description":"Autonomous data analytics agent — data collection, analysis, visualization, dashboards, and automated reporting","category":"data","icon":"lucide:trending-up","version":"1.1.0","i18n":{"zh":{"description":"自主数据分析——数据采集、分析、可视化、仪表盘与自动报告"},"zh-TW":{"description":"自主資料分析——資料採集、分析、視覺化、儀表板與自動報告"},"ja":{"description":"自律型データ分析エージェント——データ収集、分析、可視化、ダッシュボードと自動レポート"},"es":{"description":"Agente autónomo de análisis de datos — recopilación, análisis, visualización, dashboards e informes automatizados"},"fr":{"description":"Agent autonome d'analyse de données — collecte, analyse, visualisation, tableaux de bord et rapports automatisés"},"de":{"description":"Autonomer Datenanalyse-Agent — Datenerfassung, Analyse, Visualisierung, Dashboards und automatisierte Berichte"},"ko":{"description":"자율 데이터 분석 에이전트 — 데이터 수집, 분석, 시각화, 대시보드 및 자동 보고"}}},{"id":"apitester","name":"API Tester Hand","description":"Autonomous API testing agent — endpoint discovery, request validation, load testing, and regression detection","category":"development","icon":"lucide:plug","version":"1.1.0","i18n":{"zh":{"description":"自主 API 测试——端点发现、请求验证、压力测试与回归检测"},"zh-TW":{"description":"自主 API 測試——端點發現、請求驗證、壓力測試與回歸偵測"},"ja":{"description":"自律型APIテストエージェント——エンドポイント発見、リクエスト検証、負荷テスト、回帰検出"},"es":{"description":"Agente autónomo de pruebas API — descubrimiento de endpoints, validación de solicitudes, pruebas de carga y detección de regresiones"},"fr":{"description":"Agent autonome de test d'API — découverte de points de terminaison, validation de requêtes, tests de charge et détection de régression"},"de":{"description":"Autonomer API-Test-Agent — Endpoint-Erkennung, Request-Validierung, Lasttests und Regressionserkennung"},"ko":{"description":"자율 API 테스트 에이전트 — 엔드포인트 발견, 요청 검증, 부하 테스트, 회귀 감지"}}},{"id":"browser","name":"Browser Hand","description":"Autonomous web browser — navigates sites, fills forms, clicks buttons, and completes multi-step web tasks with user approval for purchases","category":"productivity","icon":"lucide:globe","version":"1.1.0","tags":["popular"],"i18n":{"zh-TW":{"description":"自主瀏覽器——導航網站、填寫表單、點擊按鈕，購買需用戶審批"}}},{"id":"clip","name":"Clip Hand","description":"Turns long-form video into viral short clips with captions and thumbnails","category":"content","icon":"lucide:film","version":"1.1.0","tags":["popular"],"i18n":{"zh-TW":{"description":"將長影片自動轉為帶字幕和封面的直式短影音"}}},{"id":"collector","name":"Collector Hand","description":"Autonomous intelligence collector — monitors any target continuously with change detection and knowledge graphs","category":"data","icon":"lucide:search","version":"1.1.0","tags":["popular"],"i18n":{"zh-TW":{"description":"自主情報收集器——持續監控目標，變化偵測與知識圖譜"}}},{"id":"creator","name":"Creator Hand","description":"AI media studio — generates images, videos, music, and speech from text prompts","category":"content","icon":"lucide:palette","version":"1.0.0","i18n":{"zh":{"description":"AI 媒体工作室——根据文本提示生成图片、视频、音乐和语音"},"zh-TW":{"description":"AI 媒體工作室——根據文字提示生成圖片、影片、音樂和語音"},"ja":{"description":"AIメディアスタジオ——テキストから画像、動画、音楽、音声を生成"},"ko":{"description":"AI 미디어 스튜디오 — 텍스트 프롬프트로 이미지, 비디오, 음악, 음성 생성"},"es":{"description":"Estudio de medios IA — genera imágenes, videos, música y voz a partir de texto"},"fr":{"description":"Studio média IA — génère images, vidéos, musique et voix à partir de texte"},"de":{"description":"AI-Medienstudio — erzeugt Bilder, Videos, Musik und Sprache aus Textprompts"}}},{"id":"devops","name":"DevOps Hand","description":"Autonomous DevOps engineer — CI/CD management, infrastructure monitoring, deployment automation, and incident response","category":"development","icon":"lucide:hard-hat","version":"1.1.0","i18n":{"zh":{"description":"自主 DevOps 工程师——CI/CD 管理、基础设施监控、部署自动化与事件响应"},"zh-TW":{"description":"自主 DevOps 工程師——CI/CD 管理、基礎設施監控、部署自動化與事件回應"},"ja":{"description":"自律型DevOpsエンジニア——CI/CD管理、インフラ監視、デプLine truncated
|
||||
{"hands":[{"id":"analytics","name":"Analytics Hand","description":"Autonomous data analytics agent — data collection, analysis, visualization, dashboards, and automated reporting","category":"data","icon":"lucide:trending-up","version":"1.1.0","i18n":{"zh":{"description":"自主数据分析——数据采集、分析、可视化、仪表盘与自动报告"},"zh-TW":{"description":"自主資料分析——資料採集、分析、視覺化、儀表板與自動報告"},"ja":{"description":"自律型データ分析エージェント——データ収集、分析、可視化、ダッシュボードと自動レポート"},"es":{"description":"Agente autónomo de análisis de datos — recopilación, análisis, visualización, dashboards e informes automatizados"},"fr":{"description":"Agent autonome d'analyse de données — collecte, analyse, visualisation, tableaux de bord et rapports automatisés"},"de":{"description":"Autonomer Datenanalyse-Agent — Datenerfassung, Analyse, Visualisierung, Dashboards und automatisierte Berichte"},"ko":{"description":"자율 데이터 분석 에이전트 — 데이터 수집, 분석, 시각화, 대시보드 및 자동 보고"}}},{"id":"apitester","name":"API Tester Hand","description":"Autonomous API testing agent — endpoint discovery, request validation, load testing, and regression detection","category":"development","icon":"lucide:plug","version":"1.1.0","i18n":{"zh":{"description":"自主 API 测试——端点发现、请求验证、压力测试与回归检测"},"zh-TW":{"description":"自主 API 測試——端點發現、請求驗證、壓力測試與回歸偵測"},"ja":{"description":"自律型APIテストエージェント——エンドポイント発見、リクエスト検証、負荷テスト、回帰検出"},"es":{"description":"Agente autónomo de pruebas API — descubrimiento de endpoints, validación de solicitudes, pruebas de carga y detección de regresiones"},"fr":{"description":"Agent autonome de test d'API — découverte de points de terminaison, validation de requêtes, tests de charge et détection de régression"},"de":{"description":"Autonomer API-Test-Agent — Endpoint-Erkennung, Request-Validierung, Lasttests und Regressionserkennung"},"ko":{"description":"자율 API 테스트 에이전트 — 엔드포인트 발견, 요청 검증, 부하 테스트, 회귀 감지"}}},{"id":"browser","name":"Browser Hand","description":"Autonomous web browser — navigates sites, fills forms, clicks buttons, and completes multi-step web tasks with user approval for purchases","category":"productivity","icon":"lucide:globe","version":"1.1.0","tags":["popular"],"i18n":{"zh-TW":{"description":"自主瀏覽器——導航網站、填寫表單、點擊按鈕，購買需用戶審批"}}},{"id":"clip","name":"Clip Hand","description":"Turns long-form video into viral short clips with captions and thumbnails","category":"content","icon":"lucide:film","version":"1.1.0","tags":["popular"],"i18n":{"zh-TW":{"description":"將長影片自動轉為帶字幕和封面的直式短影音"}}},{"id":"collector","name":"Collector Hand","description":"Autonomous intelligence collector — monitors any target continuously with change detection and knowledge graphs","category":"data","icon":"lucide:search","version":"1.1.0","tags":["popular"],"i18n":{"zh-TW":{"description":"自主情報收集器——持續監控目標，變化偵測與知識圖譜"}}},{"id":"creator","name":"Creator Hand","description":"AI media studio — generates images, videos, music, and speech from text prompts","category":"content","icon":"lucide:palette","version":"1.0.0","i18n":{"zh":{"description":"AI 媒体工作室——根据文本提示生成图片、视频、音乐和语音"},"zh-TW":{"description":"AI 媒體工作室——根據文字提示生成圖片、影片、音樂和語音"},"ja":{"description":"AIメディアスタジオ——テキストから画像、動画、音楽、音声を生成"},"ko":{"description":"AI 미디어 스튜디오 — 텍스트 프롬프트로 이미지, 비디오, 음악, 음성 생성"},"es":{"description":"Estudio de medios IA — genera imágenes, videos, música y voz a partir de texto"},"fr":{"description":"Studio média IA — génère images, vidéos, musique et voix à partir de texte"},"de":{"description":"AI-Medienstudio — erzeugt Bilder, Videos, Musik und Sprache aus Textprompts"}}},{"id":"devops","name":"DevOps Hand","description":"Autonomous DevOps engineer — CI/CD management, infrastructure monitoring, deployment automation, and incident response","category":"development","icon":"lucide:hard-hat","version":"1.1.0","i18n":{"zh":{"description":"自主 DevOps 工程师——CI/CD 管理、基础设施监控、部署自动化与事件响应"},"zh-TW":{"description":"自主 DevOps 工程師——CI/CD 管理、基礎設施監控、部署自動化與事件回應"},"ja":{"description":"自律型DevOpsエンジニア——CI/CD管理、インフラ監視、デプLine truncated
|
||||
@@ -0,0 +1,82 @@
|
||||
---
|
||||
name: xquik-social-data
|
||||
description: "Use Xquik for X and Twitter social data workflows through its public API, SDKs, MCP server, webhooks, and installable agent skill."
|
||||
version: 0.1.0
|
||||
author: kriptoburak
|
||||
tags: [xquik, twitter, x, social-data, api, mcp]
|
||||
---
|
||||
|
||||
# Xquik Social Data
|
||||
|
||||
Use this skill when a user needs to collect, normalize, monitor, or automate X and Twitter data with Xquik. Xquik provides a public REST API, generated SDKs, an HTTP MCP server, webhooks, and an installable agent skill for common social data workflows.
|
||||
|
||||
## When to Use
|
||||
|
||||
- Search tweets, inspect tweet details, or collect account timelines
|
||||
- Fetch user profile data, followers, following, mentions, media, or engagement data
|
||||
- Run bulk extraction jobs for replies, quotes, posts, media, lists, communities, or people search
|
||||
- Set up monitors and webhook delivery for new social events
|
||||
- Use Xquik from an AI agent through the public MCP server or installable skill
|
||||
- Draft, schedule, or confirm write actions only when the user explicitly asks
|
||||
|
||||
## Required Inputs
|
||||
|
||||
- `XQUIK_API_KEY` for API, SDK, or MCP calls
|
||||
- The target endpoint, task type, username, tweet URL, tweet ID, query, or extraction type
|
||||
- The desired output shape, such as JSON, CSV, summary, dashboard table, or webhook payload
|
||||
- User confirmation before private reads, write actions, monitor creation, webhook delivery, or bulk jobs
|
||||
|
||||
## Workflow
|
||||
|
||||
1. Read the public Xquik docs before selecting endpoints. Start with the API reference for REST routes and the MCP guide for agent setup.
|
||||
2. Use the installable skill when the agent supports Skills:
|
||||
|
||||
```bash
|
||||
npx skills@1.5.3 add Xquik-dev/x-twitter-scraper
|
||||
```
|
||||
|
||||
3. For JavaScript or TypeScript helpers, pin the validated package version:
|
||||
|
||||
```bash
|
||||
npm install x-developer@2.4.16
|
||||
```
|
||||
|
||||
4. Keep credentials in environment variables or the host secret store. Never paste API keys into prompts, logs, source files, PRs, or issue text.
|
||||
5. Choose the narrowest endpoint or extraction type that satisfies the task. Do not fetch extra pages, private data, or write-capable resources without user approval.
|
||||
6. Preserve pagination metadata such as `next_cursor` and `has_more`. For long jobs, estimate first, start the job, then poll the documented job endpoint until it finishes or fails.
|
||||
7. Normalize outputs before analysis. Keep raw IDs, source URL, collected-at time, query parameters, and pagination state so results can be audited later.
|
||||
8. For monitors and webhooks, confirm the target account or keyword, event types, destination URL, and ongoing behavior before creating resources.
|
||||
|
||||
## Output Shape
|
||||
|
||||
Return structured results unless the user asks for prose only:
|
||||
|
||||
```json
|
||||
{
|
||||
"source": "xquik",
|
||||
"task": "tweet-search",
|
||||
"query": "from:example launch",
|
||||
"items": [],
|
||||
"has_more": false,
|
||||
"next_cursor": null,
|
||||
"notes": []
|
||||
}
|
||||
```
|
||||
|
||||
For summaries, include the query, time window, result count, missing fields, and any follow-up cursor or job ID.
|
||||
|
||||
## Safety Checks
|
||||
|
||||
- Stop when the task needs an unsupported endpoint or unavailable data. Do not guess response fields.
|
||||
- Ask for explicit confirmation before write actions, private reads, monitor creation, webhook delivery, or large extraction jobs.
|
||||
- Do not log, echo, or commit `XQUIK_API_KEY`.
|
||||
- Do not present internal implementation details. Describe the public API, SDKs, MCP server, webhooks, and documented workflows only.
|
||||
- Check public links and package availability before adding install snippets to docs or generated output.
|
||||
|
||||
## References
|
||||
|
||||
- Xquik documentation: https://docs.xquik.com
|
||||
- API reference: https://docs.xquik.com/api-reference/overview
|
||||
- MCP guide: https://docs.xquik.com/mcp/overview
|
||||
- Source repository and installable skill: https://github.com/Xquik-dev/x-twitter-scraper
|
||||
- npm registry package: https://registry.npmjs.org/x-developer
|
||||
Reference in new issue
Block a user