diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 0b60a1401..74b978b39 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -863,6 +863,17 @@ }, "homepage": "https://docs.pixeltable.com" }, + { + "name": "xquik", + "displayName": "Xquik", + "description": "Research X content, monitor accounts or keywords, collect media, export followers, and prepare confirmation-gated actions through the Xquik MCP server.", + "category": "productivity", + "source": "./partner-built/xquik", + "homepage": "https://docs.xquik.com/mcp/overview", + "author": { + "name": "Xquik" + } + }, { "name": "grafana-assistant", "displayName": "Grafana Assistant", diff --git a/partner-built/xquik/.claude-plugin/plugin.json b/partner-built/xquik/.claude-plugin/plugin.json new file mode 100644 index 000000000..d7cecf905 --- /dev/null +++ b/partner-built/xquik/.claude-plugin/plugin.json @@ -0,0 +1,20 @@ +{ + "name": "xquik", + "version": "0.1.0", + "description": "Xquik workflows for X data research, media collection, follower export, monitoring, webhooks, and confirmation-gated actions through the Xquik MCP server.", + "author": { + "name": "Xquik", + "url": "https://xquik.com" + }, + "repository": "https://github.com/Xquik-dev/x-twitter-scraper", + "homepage": "https://docs.xquik.com/mcp/overview", + "license": "Apache-2.0", + "keywords": [ + "xquik", + "x", + "mcp", + "social", + "research", + "automation" + ] +} diff --git a/partner-built/xquik/.mcp.json b/partner-built/xquik/.mcp.json new file mode 100644 index 000000000..61eab73c0 --- /dev/null +++ b/partner-built/xquik/.mcp.json @@ -0,0 +1,11 @@ +{ + "mcpServers": { + "xquik": { + "type": "http", + "url": "https://xquik.com/mcp", + "headers": { + "Authorization": "Bearer ${XQUIK_API_KEY}" + } + } + } +} diff --git a/partner-built/xquik/LICENSE b/partner-built/xquik/LICENSE new file mode 100644 index 000000000..605ab09d0 --- /dev/null +++ b/partner-built/xquik/LICENSE @@ -0,0 +1,3 @@ +Apache License 2.0 + +This plugin is licensed under the Apache License, Version 2.0. See the repository root LICENSE file for the full terms. diff --git a/partner-built/xquik/README.md b/partner-built/xquik/README.md new file mode 100644 index 000000000..9b48d7ae2 --- /dev/null +++ b/partner-built/xquik/README.md @@ -0,0 +1,55 @@ +# Xquik Plugin for Claude Code and Cowork + +Use Xquik to research X content, monitor accounts or keywords, collect media, export followers, and prepare confirmation-gated actions from Claude. + +## MCP Integration + +This plugin configures the Xquik MCP server: + +```json +{ + "xquik": { + "type": "http", + "url": "https://xquik.com/mcp" + } +} +``` + +Set `XQUIK_API_KEY` before using the MCP server. Create an API key from the Xquik dashboard. + +## Included Skill + +| Skill | What it does | +| --- | --- | +| `/xquik:x-research` | Plans X research workflows, chooses the narrowest Xquik MCP action, and formats results for analysis or export | + +## Common Workflows + +- Search posts and replies for a topic +- Inspect public profile context +- Export follower or following lists +- Collect tweet media for analysis +- Prepare monitor and webhook workflows +- Draft confirmation-gated X actions + +## Installation + +### Claude Code + +```bash +claude plugin marketplace add anthropics/knowledge-work-plugins +claude plugin install xquik@knowledge-work-plugins +``` + +Then set `XQUIK_API_KEY` in your environment and restart Claude Code. + +## Links + +- Docs: https://docs.xquik.com/mcp/overview +- Dashboard: https://dashboard.xquik.com +- Repository: https://github.com/Xquik-dev/x-twitter-scraper +- npm: https://www.npmjs.com/package/x-twitter-scraper + +## License + +Apache-2.0. See [LICENSE](LICENSE). diff --git a/partner-built/xquik/skills/x-research/SKILL.md b/partner-built/xquik/skills/x-research/SKILL.md new file mode 100644 index 000000000..daf87ca65 --- /dev/null +++ b/partner-built/xquik/skills/x-research/SKILL.md @@ -0,0 +1,42 @@ +--- +name: x-research +description: Use Xquik to research X content, accounts, media, follower lists, monitors, and webhooks through the authenticated Xquik MCP server. +user-invocable: true +argument-hint: "[query, account, URL, or workflow]" +--- + +# X Research + +Use Xquik when the user wants to research X data or prepare an automation workflow. The user's request is available in "$ARGUMENTS". + +## Before Calling Tools + +1. Identify the target: search query, account, tweet URL, follower list, media task, monitor, or webhook. +2. Ask for missing required inputs only when the task cannot proceed. +3. Prefer read-only research unless the user explicitly asks for an action. +4. For write-like or externally visible actions, show a concise preview and ask for confirmation. + +## Research Paths + +- **Topic research**: search posts and replies, then summarize themes, examples, and relevant URLs. +- **Account research**: look up profile context, recent posts, follower or following exports, and media when requested. +- **Media collection**: collect media URLs and metadata, then return a structured table or export-ready JSON. +- **Monitoring**: propose account or keyword monitor rules, webhook payload needs, and output format. +- **Action prep**: draft the action payload, explain what will be sent, and wait for confirmation. + +## Output Format + +Return one of these formats based on the task: + +- A concise summary with source tweet URLs +- A table with author, URL, timestamp, text, and metrics when available +- JSON or CSV-ready rows for export workflows +- A monitor or webhook setup checklist +- A confirmation prompt for action workflows + +## Safety + +- Never print API keys, cookies, bearer tokens, or auth headers. +- Do not claim access to private X data. +- Keep unsupported fields out of examples. +- Keep pagination cursors visible when results are partial.