@superagnt/x-twitter-data 2.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +72 -0
- package/index.js +1774 -0
- package/openclaw.plugin.json +16 -0
- package/package.json +48 -0
package/README.md
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# X (Twitter) data for OpenClaw — superagnt plugin
|
|
2
|
+
|
|
3
|
+
Use one API key to pull X data (posts, profiles, and social graph data) for agents, automations, and analytics. Structured JSON, credit-based pricing, no separate vendor accounts. Unified access to tweets, user profiles, followers, search, and hashtag streams. Built for LLMs and automation — not one-off scraping.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
openclaw plugins install @superagnt/x-twitter-data
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
This package is the official **OpenClaw** plugin for **X (Twitter)** social and public data via [superagnt](https://superagnt.com). Pair it with the [documentation](https://superagnt.com) and your superagnt API key.
|
|
12
|
+
|
|
13
|
+
## Live MCP mode (recommended)
|
|
14
|
+
|
|
15
|
+
Set a workspace MCP token and the plugin upgrades itself at load: it fetches
|
|
16
|
+
the live tool list from the scoped MCP endpoint and proxies calls through it —
|
|
17
|
+
the tool surface then grows with `agnt_tools_enable`, no plugin update needed.
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
export SUPERAGNT_MCP_TOKEN=... # from the MCP server card in the dashboard
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Without the token the plugin uses its built-in toolset with your
|
|
24
|
+
`SUPERAGNT_API_KEY` — no behavior change from previous versions.
|
|
25
|
+
|
|
26
|
+
## Overview
|
|
27
|
+
|
|
28
|
+
Unified access to tweets, user profiles, followers, search, and hashtag streams. Built for LLMs and automation — not one-off scraping.
|
|
29
|
+
|
|
30
|
+
### Highlights
|
|
31
|
+
|
|
32
|
+
- Structured JSON responses for X resources
|
|
33
|
+
- Single API key and unified credit balance across superagnt
|
|
34
|
+
- Designed for agent workflows, batch jobs, and real-time tools
|
|
35
|
+
- Composable with other superagnt providers in one stack
|
|
36
|
+
- OpenAPI-documented endpoints for codegen and testing
|
|
37
|
+
|
|
38
|
+
### Example use cases
|
|
39
|
+
|
|
40
|
+
- Social and creator intelligence agents using X
|
|
41
|
+
- Marketing and research teams monitoring accounts and content
|
|
42
|
+
- Product teams building alerts, digests, and dashboards
|
|
43
|
+
- Developers prototyping LLM tools that need live network data
|
|
44
|
+
- Data teams joining X signals with CRM or warehouse data
|
|
45
|
+
|
|
46
|
+
## Authentication
|
|
47
|
+
|
|
48
|
+
Use a single **superagnt API key** (Bearer token). Set `SUPERAGNT_API_KEY` in your environment, or complete browser login when the gateway prompts you. Create and manage keys in the [superagnt dashboard](https://app.superagnt.com/dashboard).
|
|
49
|
+
|
|
50
|
+
## API coverage
|
|
51
|
+
|
|
52
|
+
| | |
|
|
53
|
+
| --- | --- |
|
|
54
|
+
| **Platform** | `x` |
|
|
55
|
+
| **REST base** | `https://api.superagnt.com/v1/data/x` |
|
|
56
|
+
| **OpenAPI operations** | 52 |
|
|
57
|
+
| **OpenClaw tools** | 52 |
|
|
58
|
+
|
|
59
|
+
## Documentation
|
|
60
|
+
|
|
61
|
+
- [Documentation](https://superagnt.com) — getting started and concepts
|
|
62
|
+
- [API reference (X (Twitter))](https://superagnt.com/apis/social/x) — endpoints and schemas
|
|
63
|
+
- [Dashboard](https://app.superagnt.com/dashboard) — API keys and usage
|
|
64
|
+
|
|
65
|
+
## Related
|
|
66
|
+
|
|
67
|
+
- **Skill (curl-oriented):** `clawhub install x-twitter-data` on [ClawHub](https://clawhub.ai/superagnt/skills/x-twitter-data)
|
|
68
|
+
- **All platforms plugin:** `@superagnt/openclaw-agnt-data` if you need LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook in one package.
|
|
69
|
+
|
|
70
|
+
## License
|
|
71
|
+
|
|
72
|
+
MIT
|