@xquik/tweetclaw 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Xquik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# TweetClaw
+
+X/Twitter automation for [OpenClaw](https://github.com/nicepkg/openclaw). Search tweets, post, extract data, run giveaways, monitor accounts  - all from your chat.
+
+Powered by [Xquik](https://xquik.com), the all-in-one X automation platform.
+
+## Install
+
+```bash
+openclaw plugins install @xquik/tweetclaw
+```
+
+## Configure
+
+1. Get an API key at [xquik.com/account-manager](https://xquik.com/account-manager)
+2. Set it in OpenClaw:
+
+```bash
+openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'
+```
+
+Optional settings:
+
+```bash
+openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
+openclaw config set plugins.entries.tweetclaw.config.pollingInterval 60
+```
+
+## Tools
+
+TweetClaw uses the [Cloudflare Code Mode pattern](https://github.com/cloudflare/mcp)  - just 2 tools that cover the entire API:
+
+### `explore` (free, no network)
+
+Search the API spec to find endpoints. No API calls are made.
+
+```
+You: "What endpoints are available for tweet composition?"
+
+AI uses explore → filters spec by category "composition"
+→ Returns matching endpoints with parameters and response shapes
+```
+
+### `tweetclaw` (execute API calls)
+
+Execute authenticated API calls. Auth is injected automatically  - the LLM never sees your API key.
+
+```
+You: "Search tweets about AI agents"
+
+AI uses explore → finds /api/v1/x/tweets/search
+AI uses tweetclaw → calls the endpoint with auth
+→ Returns tweet results
+```
+
+```
+You: "Post a tweet saying 'Hello from TweetClaw!'"
+
+AI uses tweetclaw → finds connected account, posts tweet
+→ Returns { tweetId, success: true }
+```
+
+## Commands
+
+Instant responses, no LLM needed:
+
+| Command | Description |
+|---------|-------------|
+| `/xstatus` | Account info, subscription status, usage |
+| `/xtrends` | Trending topics from curated sources |
+| `/xtrends tech` | Trending topics filtered by category |
+
+## Event Notifications
+
+When polling is enabled (default), TweetClaw checks for new events every 60 seconds and delivers them to your chat:
+
+- **Monitor alerts**: New tweets, replies, quotes, retweets from monitored accounts
+- **Follower changes**: Gained or lost followers on monitored accounts
+
+Set up a monitor first:
+
+```
+You: "Monitor @elonmusk for new tweets and follower changes"
+```
+
+## API Coverage
+
+40+ endpoints across these categories:
+
+| Category | Examples |
+|----------|---------|
+| **Composition** | Compose, refine, score tweets; manage drafts; analyze writing styles |
+| **Twitter** | Search tweets, look up users, check follow relationships |
+| **Extraction** | Run extraction jobs (reply-extractor, community-explorer, etc.) |
+| **Draws** | Run giveaway draws on tweets, export results |
+| **Monitoring** | Create monitors, view events, manage webhooks |
+| **Media** | Download tweet media, upload media via URL |
+| **Write Actions** | Post tweets, like, retweet, follow, DM, update profile |
+| **Account** | Manage API keys, subscription, connected X accounts |
+| **Trends** | X trending topics, curated radar from multiple sources |
+
+## Pricing
+
+**Free tier** (no subscription needed):
+- Tweet composition, style analysis, drafts
+- Curated trending radar
+- Account management, API keys
+- Integrations management
+
+**Subscription ($20/month)** for full access:
+- Tweet search, user lookup, media download
+- Extractions, giveaway draws
+- Account monitors, events, webhooks
+- Write actions (post, like, retweet, follow, DM)
+- X trending topics
+
+When a paid endpoint returns 402, TweetClaw automatically provides a checkout URL.
+
+## License
+
+MIT

package/openclaw.plugin.json

@@ -0,0 +1,24 @@
+{
+  "id": "tweetclaw",
+  "name": "TweetClaw",
+  "version": "1.0.0",
+  "description": "X/Twitter automation powered by Xquik - search tweets, post, extract data, run giveaways, monitor accounts, compose with AI",
+  "author": "Xquik",
+  "license": "MIT",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiKey": { "type": "string", "description": "Xquik API key (get one at xquik.com/account-manager)" },
+      "baseUrl": { "type": "string", "default": "https://xquik.com" },
+      "pollingInterval": { "type": "number", "default": 60, "description": "Event polling interval in seconds" },
+      "pollingEnabled": { "type": "boolean", "default": true }
+    },
+    "required": ["apiKey"]
+  },
+  "uiHints": {
+    "apiKey": { "label": "Xquik API Key", "sensitive": true, "placeholder": "xq_..." },
+    "baseUrl": { "label": "API Base URL", "placeholder": "https://xquik.com" },
+    "pollingInterval": { "label": "Event Poll Interval (seconds)" },
+    "pollingEnabled": { "label": "Enable Event Notifications" }
+  }
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@xquik/tweetclaw",
+  "version": "1.0.0",
+  "description": "X/Twitter automation for OpenClaw - search, post, extract, draw, monitor via Xquik",
+  "license": "MIT",
+  "type": "module",
+  "openclaw": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "files": [
+    "src/",
+    "openclaw.plugin.json"
+  ],
+  "keywords": [
+    "openclaw-plugin",
+    "twitter",
+    "x",
+    "automation",
+    "tweetclaw",
+    "xquik"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "knip": "knip --strict --include-libs --treat-config-hints-as-errors",
+    "cpd": "jscpd .",
+    "check-suppressions": "tsx check-suppressions.ts",
+    "check-em-dash": "tsx check-em-dash.ts",
+    "check:all": "npm run typecheck && npm run lint && npm run cpd && npm run knip && npm run check-suppressions && npm run check-em-dash && npm run test:coverage"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@sinclair/typebox": "^0.34.0",
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/eslint-plugin": "^1.6.11",
+    "eslint": "^10.0.3",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import-x": "^4.16.2",
+    "eslint-plugin-n": "^17.24.0",
+    "eslint-plugin-no-secrets": "^2.3.3",
+    "eslint-plugin-promise": "^7.2.1",
+    "eslint-plugin-regexp": "^3.1.0",
+    "eslint-plugin-security": "^4.0.0",
+    "eslint-plugin-sonarjs": "^4.0.2",
+    "eslint-plugin-unicorn": "^63.0.0",
+    "globals": "^17.4.0",
+    "jscpd": "^4.0.8",
+    "knip": "^5.86.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0"
+  }
+}