Skip to content

Add x-twitter-scraper skill#19

Closed
kriptoburak wants to merge 2 commits into
block:mainfrom
kriptoburak:add-x-twitter-scraper
Closed

Add x-twitter-scraper skill#19
kriptoburak wants to merge 2 commits into
block:mainfrom
kriptoburak:add-x-twitter-scraper

Conversation

@kriptoburak

@kriptoburak kriptoburak commented Mar 29, 2026 •
edited
Loading

Copy link
Copy Markdown

Summary

  • Adds x-twitter-scraper, an X (Twitter) data platform skill for AI agents
  • 120 REST API endpoints, 2 MCP tools (explore + xquik), HMAC webhooks
  • Covers tweet search, user lookup, follower extraction, write actions, account monitoring, giveaway draws, trending topics, AI tweet composition, and Telegram integrations
  • Includes 7 reference files: API endpoints, MCP setup (10 platforms), MCP tools, Python examples, TypeScript types, webhooks, and extractions
  • Frontmatter adapted to match this repo's required format (name, description, author, version, tags)

Skill contents

File Purpose
SKILL.md Main skill - quick reference, pricing, decision trees, auth, error handling, pagination, extraction workflow, giveaway draws, webhook handling, monitoring setup, MCP server
references/api-endpoints.md All 120 REST endpoints with methods, paths, parameters, response shapes
references/mcp-setup.md MCP server config for Claude, ChatGPT, Cursor, VS Code, Windsurf, and more
references/mcp-tools.md MCP tool selection rules, workflow patterns, common mistakes
references/python-examples.md Python equivalents of all JavaScript examples
references/types.md TypeScript type definitions for all API objects
references/webhooks.md Extended webhook examples, local testing, delivery monitoring
references/extractions.md 23 extraction tool types, export column details

Test plan

  • CI validation passes (SKILL.md present, valid YAML frontmatter, folder/name match)
  • Skill installable via npx skills add https://github.com/block/Agent-Skills --skill x-twitter-scraper
  • Reference file links resolve correctly from SKILL.md

@github-actions

github-actions Bot commented Mar 29, 2026 •
edited
Loading

Copy link
Copy Markdown

✅ Validate Skills — PASSED

Summary: FAIL=0 · WARN=0
Changed skill dirs: x-twitter-scraper

Output (last 200 lines)

✅ Found 8 skill directories.
✅ api-setup: structure validated
✅ beads: structure validated
✅ code-review: structure validated
✅ frontend-design: structure validated
✅ goose-blog-post: structure validated
✅ rp-why: structure validated
✅ testing-strategy: structure validated
✅ x-twitter-scraper: structure validated

Structure validation PASSED.

@github-actions

github-actions Bot commented Mar 29, 2026 •
edited
Loading

Copy link
Copy Markdown

🛡️ Skills Security Scan — WARN

Summary: FAIL=0 · WARN=52 · FILES=8
Changed skills scanned: x-twitter-scraper

⚠️ WARN requires investigation + CODEOWNERS review.

⚠️ Warnings

x-twitter-scraper

  • content:entropy-high-line — x-twitter-scraper/SKILL.md:20
Xquik is an X (Twitter) real-time data platform providing a REST API (120 endpoints), 2 MCP tools, and HMAC webhooks. It covers account monitoring, bulk data extraction (23 tools), giveaway draws, tweet/user lookups, media downloads, follow…
  • content:entropy-high-file — x-twitter-scraper/SKILL.md:1
---
  • network:url — x-twitter-scraper/SKILL.md:24
Your knowledge of the Xquik API may be outdated. **Prefer retrieval from docs** - fetch the latest at [docs.xquik.com](https://docs.xquik.com) before citing limits, pricing, or API signatures.

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:30
| Xquik docs | [docs.xquik.com](https://docs.xquik.com) | Limits, pricing, API reference, endpoint schemas |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:31
| API spec | `explore` MCP tool or [docs.xquik.com/api-reference/overview](https://docs.xquik.com/api-reference/overview) | Endpoint parameters, response shapes |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:32
| Docs MCP | `https://docs.xquik.com/mcp` (no auth) | Search docs from AI tools |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:33
| Billing guide | [docs.xquik.com/guides/billing](https://docs.xquik.com/guides/billing) | Credit costs, subscription tiers, MPP pricing |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:41
| **Base URL** | `https://xquik.com/api/v1` |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:43
| **MCP endpoint** | `https://xquik.com/mcp` (StreamableHTTP, same API key) |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:49
| **Docs** | [docs.xquik.com](https://docs.xquik.com) |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:279
const BASE = "https://xquik.com/api/v1";

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:521
| `tweetUrl` | string | **Required.** Full tweet URL: `https://x.com/user/status/ID` |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:541
    tweetUrl: "https://x.com/burakbayir/status/1893456789012345678",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:642
    url: "https://your-server.com/webhook",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/SKILL.md:656
The MCP server at `https://xquik.com/mcp` provides 2 tools. StreamableHTTP transport. API key auth (`x-api-key` header) for CLI/IDE clients; OAuth 2.1 for web clients (Claude.ai, ChatGPT Developer Mode).

Guidance: Review: URL present; confirm expected destination and purpose.

  • content:entropy-high-file — x-twitter-scraper/references/api-endpoints.md:1
# Xquik REST API Endpoints
  • network:url — x-twitter-scraper/references/api-endpoints.md:3
Base URL: `https://xquik.com/api/v1`

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:225
  "url": "https://your-server.com/webhook",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:302
  "tweetUrl": "https://x.com/user/status/1893456789012345678",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:324
  "tweetUrl": "https://x.com/user/status/1893456789012345678",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:487
  "coverImage": "https://pbs.twimg.com/...",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:623
  "galleryUrl": "https://xquik.com/gallery/abc123",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:631
  "galleryUrl": "https://xquik.com/gallery/def456",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:637
First download is metered (counts toward monthly quota). Subsequent requests for the same tweet return cached URLs at no cost (`cacheHit: true`). All downloads are saved to the gallery at `https://xquik.com/gallery`.

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:696
      "url": "https://example.com/article",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:697
      "imageUrl": "https://example.com/image.png",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/api-endpoints.md:1035
  "url": "https://checkout.stripe.com/c/pay/..."

Guidance: Review: URL present; confirm expected destination and purpose.

  • content:entropy-high-line — x-twitter-scraper/references/mcp-setup.md:172
The agent writes async JavaScript arrow functions that run in a sandboxed environment. Auth is injected automatically. The sandbox covers all 97 REST API endpoints across 12 categories: account, automations, bot, composition, extraction, in…
  • network:url — x-twitter-scraper/references/mcp-setup.md:8
| Endpoint | `https://xquik.com/mcp` |

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:17
Claude Desktop only supports stdio transport. Use `mcp-remote` as a bridge (requires [Node.js](https://nodejs.org)).

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:28
        "https://xquik.com/mcp",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:46
      "url": "https://xquik.com/mcp",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:61
Create a Custom GPT and add Xquik as an Action using the OpenAPI schema at `https://docs.xquik.com/openapi.json`. Set the API key under Authentication > API Key > Header `x-api-key`.

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:65
Use the [OpenAI Agents SDK](https://openai.github.io/openai-agents-python/mcp/) for programmatic access:

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:71
    url="https://xquik.com/mcp",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:81
ChatGPT Developer Mode supports MCP connectors via OAuth. Add Xquik from **Settings > Developer Mode > MCP Tools > Add**. Enter `https://xquik.com/mcp` as the endpoint. OAuth handles authentication automatically.

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:89
url = "https://xquik.com/mcp"

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:101
      "url": "https://xquik.com/mcp",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:119
      "url": "https://xquik.com/mcp",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:136
      "serverUrl": "https://xquik.com/mcp",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:154
      "url": "https://xquik.com/mcp",

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:165
The default MCP server (v2) at `https://xquik.com/mcp` uses a **code-execution sandbox model** with 2 tools:

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:193
- "What does this tweet say? https://x.com/elonmusk/status/1893456789012345678"

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:195
- "Pick 3 winners from this tweet: https://x.com/burakbayir/status/1893456789012345678"

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/mcp-setup.md:200
- "Set up a webhook at https://my-server.com/events for new tweets"

Guidance: Review: URL present; confirm expected destination and purpose.

  • content:entropy-high-line — x-twitter-scraper/references/mcp-tools.md:150
- **Free**: account info, compose (all steps), styles (cached lookup/save/delete/compare), drafts, radar (via `xquik` tool, all 7 sources), subscribe, API keys, bot endpoints, integrations, X account management, automations (create, list, u…
  • network:url — x-twitter-scraper/references/mcp-tools.md:3
The MCP server at `https://xquik.com/mcp` uses a code-execution sandbox model with 2 tools. The agent writes async JavaScript arrow functions that run in a sandboxed environment with auth injected automatically.

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/python-examples.md:11
BASE = "https://xquik.com/api/v1"

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/python-examples.md:91
    "tweetUrl": "https://x.com/burakbayir/status/1893456789012345678",

Guidance: Review: URL present; confirm expected destination and purpose.

  • content:entropy-high-file — x-twitter-scraper/references/types.md:1
# Xquik TypeScript Type Definitions
  • network:url — x-twitter-scraper/references/webhooks.md:184
Use [ngrok](https://ngrok.com) to expose a local server:

Guidance: Review: URL present; confirm expected destination and purpose.

  • network:url — x-twitter-scraper/references/webhooks.md:195
Or use [RequestBin](https://requestbin.com) for quick inspection without running a server.

Guidance: Review: URL present; confirm expected destination and purpose.

Notes: This comment auto-updates on each push to keep PRs clean.

@github-advanced-security

github-advanced-security AI commented Apr 9, 2026

Copy link
Copy Markdown

You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool.

What Enabling Code Scanning Means:

  • The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
  • Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
  • You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

For more information about GitHub Code Scanning, check out the documentation.

@kriptoburak
Add x-twitter-scraper skill — X (Twitter) data platform for AI agents
e72b18e 
120 REST API endpoints, 2 MCP tools, HMAC webhooks covering tweet search,
user lookup, follower extraction, write actions, monitoring, giveaway draws,
and trending topics. Includes 7 reference files for API endpoints, MCP setup,
Python examples, TypeScript types, webhooks, and extractions.

Signed-off-by: Burak Bayır <burakbayir1@gmail.com>
@kriptoburak
fix: replace em dashes with hyphens
d3412c0 
Signed-off-by: Burak Bayır <burakbayir1@gmail.com>
@kriptoburak
kriptoburak force-pushed the add-x-twitter-scraper branch from 391c59f to 954819a Compare April 14, 2026 17:02
@kriptoburak
kriptoburak force-pushed the add-x-twitter-scraper branch from 954819a to d3412c0 Compare April 23, 2026 01:24
@kriptoburak

kriptoburak commented May 11, 2026

Copy link
Copy Markdown
Author

Closing this older submission in favor of the smaller, current PR #33. The newer PR has the same Xquik discovery goal with a narrower changed skill directory, passing validation, and a much smaller security-review surface for maintainers.

@kriptoburak kriptoburak mentioned this pull request May 11, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

security-review-required

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@kriptoburak @github-advanced-security