x-twitter-scraper 0.12.2 → 0.12.4
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/CHANGELOG.md +15 -5
- package/README.md +50 -64
- package/package.json +1 -1
- package/skills/x-twitter-scraper/SKILL.md +64 -72
- package/skills/x-twitter-scraper/metadata.json +2 -8
- package/skills/x-twitter-scraper/references/draws.md +24 -24
- package/skills/x-twitter-scraper/references/extractions.md +71 -62
- package/skills/x-twitter-scraper/references/mcp-setup.md +29 -29
- package/skills/x-twitter-scraper/references/mcp-tools.md +137 -121
- package/skills/x-twitter-scraper/references/python-examples.md +5 -5
- package/skills/x-twitter-scraper/references/security.md +8 -8
- package/skills/x-twitter-scraper/references/types-mcp-output-schemas.md +10 -19
- package/skills/x-twitter-scraper/references/types.md +29 -46
- package/skills/x-twitter-scraper/references/usage.md +5 -5
- package/skills/x-twitter-scraper/references/webhooks.md +28 -31
- package/skills/x-twitter-scraper/references/workflows.md +70 -71
- package/skills/x-twitter-scraper/skill-card.md +10 -10
- package/skills/x-twitter-scraper/skillspector-report.md +4 -4
- package/skills/xquik-social-research/SKILL.md +15 -15
- package/src/version.ts +1 -1
- package/version.d.mts +1 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
- package/version.mjs +1 -1
- package/skills/x-twitter-scraper/references/types-mcp-add-webhook.md +0 -14
- package/skills/x-twitter-scraper/references/types-mcp-check-follow.md +0 -10
- package/skills/x-twitter-scraper/references/types-mcp-compose-tweet.md +0 -31
- package/skills/x-twitter-scraper/references/types-mcp-estimate-extraction.md +0 -15
- package/skills/x-twitter-scraper/references/types-mcp-get-account.md +0 -26
- package/skills/x-twitter-scraper/references/types-mcp-get-draw.md +0 -30
- package/skills/x-twitter-scraper/references/types-mcp-get-events.md +0 -19
- package/skills/x-twitter-scraper/references/types-mcp-get-trends.md +0 -16
- package/skills/x-twitter-scraper/references/types-mcp-get-user-info.md +0 -16
- package/skills/x-twitter-scraper/references/types-mcp-list-monitors.md +0 -15
- package/skills/x-twitter-scraper/references/types-mcp-lookup-tweet.md +0 -25
- package/skills/x-twitter-scraper/references/types-mcp-refine-tweet.md +0 -13
- package/skills/x-twitter-scraper/references/types-mcp-run-draw.md +0 -18
- package/skills/x-twitter-scraper/references/types-mcp-run-extraction.md +0 -12
- package/skills/x-twitter-scraper/references/types-mcp-score-tweet.md +0 -16
- package/skills/x-twitter-scraper/references/types-mcp-search-tweets.md +0 -17
- package/skills/x-twitter-scraper/references/types-mcp-test-webhook.md +0 -11
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: get-account
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpAccount {
|
|
6
|
-
plan: "active" | "inactive";
|
|
7
|
-
monitorsAllowed: number; // Deprecated; monitor slots are unlimited
|
|
8
|
-
monitorsUsed: number; // Number of active monitors
|
|
9
|
-
monitorUsage: {
|
|
10
|
-
activeDailyEstimate: string;
|
|
11
|
-
activeHourlyBurn: string;
|
|
12
|
-
creditsPerActiveMonitorDay: string;
|
|
13
|
-
creditsPerActiveMonitorHour: string;
|
|
14
|
-
eventsIncluded: boolean;
|
|
15
|
-
instantCheckIntervalSeconds: number;
|
|
16
|
-
unlimitedSlots: boolean;
|
|
17
|
-
};
|
|
18
|
-
creditInfo?: {
|
|
19
|
-
balance: string;
|
|
20
|
-
lifetimePurchased: string;
|
|
21
|
-
lifetimeUsed: string;
|
|
22
|
-
};
|
|
23
|
-
xUsername?: string;
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
```
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: get-draw
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpDrawDetails {
|
|
6
|
-
draw: {
|
|
7
|
-
id: string; // Draw ID
|
|
8
|
-
status: string; // Draw status (completed, failed)
|
|
9
|
-
createdAt: string; // ISO 8601 timestamp
|
|
10
|
-
drawnAt?: string; // ISO 8601 timestamp when winners were drawn
|
|
11
|
-
totalEntries: number; // Total reply count before filtering
|
|
12
|
-
validEntries: number; // Entries remaining after filters applied
|
|
13
|
-
tweetId: string; // Giveaway tweet ID
|
|
14
|
-
tweetUrl: string; // Full URL of the giveaway tweet
|
|
15
|
-
tweetText: string; // Giveaway tweet text
|
|
16
|
-
tweetAuthorUsername: string; // Username of the giveaway tweet author
|
|
17
|
-
tweetLikeCount: number; // Tweet like count at draw time
|
|
18
|
-
tweetRetweetCount: number; // Tweet retweet count at draw time
|
|
19
|
-
tweetReplyCount: number; // Tweet reply count at draw time
|
|
20
|
-
tweetQuoteCount: number; // Tweet quote count at draw time
|
|
21
|
-
};
|
|
22
|
-
winners: {
|
|
23
|
-
position: number; // Winner position (1-based)
|
|
24
|
-
authorUsername: string; // X username of the winner
|
|
25
|
-
tweetId: string; // Tweet ID of the winning reply
|
|
26
|
-
isBackup: boolean; // Whether this is a backup winner
|
|
27
|
-
}[];
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
```
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: get-events
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpEventList {
|
|
6
|
-
events: {
|
|
7
|
-
id: string; // Event ID (use with get-event for full details)
|
|
8
|
-
xUsername: string; // Username of the monitored account
|
|
9
|
-
eventType: string; // Event type (tweet.new, tweet.reply, etc.)
|
|
10
|
-
eventData: unknown; // Full event payload (tweet text, author, metrics)
|
|
11
|
-
monitoredAccountId: string; // ID of the monitored account
|
|
12
|
-
createdAt: string; // ISO 8601 when event was recorded
|
|
13
|
-
occurredAt: string; // ISO 8601 when event occurred on X
|
|
14
|
-
}[];
|
|
15
|
-
hasMore: boolean; // Whether more results are available
|
|
16
|
-
nextCursor?: string; // Pass as afterCursor to fetch the next page
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
```
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: get-trends
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpTrends {
|
|
6
|
-
woeid: number;
|
|
7
|
-
total: number;
|
|
8
|
-
trends: {
|
|
9
|
-
name: string; // Trend name or hashtag
|
|
10
|
-
rank?: number; // Trend rank position
|
|
11
|
-
description?: string; // Trend description or context
|
|
12
|
-
query?: string; // Search query to find tweets for this trend
|
|
13
|
-
}[];
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
```
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: get-user-info
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpUserInfo {
|
|
6
|
-
username: string; // X username (without @)
|
|
7
|
-
name: string; // Display name
|
|
8
|
-
description: string; // User bio text
|
|
9
|
-
followersCount: number; // Number of followers
|
|
10
|
-
followingCount: number; // Number of accounts followed
|
|
11
|
-
profilePicture: string; // Profile picture URL
|
|
12
|
-
// Not returned: verified, location, createdAt, statusesCount
|
|
13
|
-
// Use REST GET /x/users/{id} for the full profile
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
```
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: list-monitors
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpMonitorList {
|
|
6
|
-
monitors: {
|
|
7
|
-
id: string; // Monitor ID (use with remove-monitor, get-events monitorId filter)
|
|
8
|
-
xUsername: string; // Monitored X username
|
|
9
|
-
eventTypes: string[]; // Subscribed event types
|
|
10
|
-
isActive: boolean; // Whether the monitor is currently active
|
|
11
|
-
createdAt: string; // ISO 8601 timestamp
|
|
12
|
-
}[];
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
```
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: lookup-tweet
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpTweetLookup {
|
|
6
|
-
tweet: {
|
|
7
|
-
id: string; // Tweet ID
|
|
8
|
-
text: string; // Tweet text
|
|
9
|
-
likeCount: number; // Number of likes
|
|
10
|
-
retweetCount: number; // Number of retweets
|
|
11
|
-
replyCount: number; // Number of replies
|
|
12
|
-
quoteCount: number; // Number of quote tweets
|
|
13
|
-
viewCount: number; // Number of views
|
|
14
|
-
bookmarkCount: number; // Number of bookmarks
|
|
15
|
-
media?: { mediaUrl: string; type: string; url: string }[]; // Attached photos/videos
|
|
16
|
-
};
|
|
17
|
-
author?: { // Tweet author details
|
|
18
|
-
id: string; // Author user ID
|
|
19
|
-
username: string; // Author X username
|
|
20
|
-
followers: number; // Author follower count
|
|
21
|
-
verified: boolean; // Whether the author is verified
|
|
22
|
-
};
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
```
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: refine-tweet
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpRefineTweet {
|
|
6
|
-
compositionGuidance: string[]; // Targeted guidance based on user preferences
|
|
7
|
-
examplePatterns: {
|
|
8
|
-
pattern: string; // Tweet structure template
|
|
9
|
-
description: string; // What this pattern achieves
|
|
10
|
-
}[];
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
```
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: run-draw
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpDrawResult {
|
|
6
|
-
id: string; // Draw ID (use with get-draw for full details)
|
|
7
|
-
tweetId: string; // Giveaway tweet ID
|
|
8
|
-
totalEntries: number; // Total reply count before filtering
|
|
9
|
-
validEntries: number; // Valid entries after filtering
|
|
10
|
-
winners: {
|
|
11
|
-
position: number; // Winner position (1-based)
|
|
12
|
-
authorUsername: string; // X username of the winner
|
|
13
|
-
tweetId: string; // Tweet ID of the winning reply
|
|
14
|
-
isBackup: boolean; // Whether this is a backup winner
|
|
15
|
-
}[];
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
```
|
|
@@ -1,12 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: run-extraction
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpExtractionJob {
|
|
6
|
-
id: string; // Extraction job ID (use with get-extraction for results)
|
|
7
|
-
toolType: string; // Extraction tool type used
|
|
8
|
-
status: string; // Job status
|
|
9
|
-
totalResults: number; // Number of results extracted
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
```
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: score-tweet
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpScoreTweet {
|
|
6
|
-
totalChecks: number; // Total number of checks performed
|
|
7
|
-
passedCount: number; // Number of checks that passed
|
|
8
|
-
topSuggestion: string; // Highest-impact improvement suggestion
|
|
9
|
-
checklist: {
|
|
10
|
-
factor: string; // What was checked
|
|
11
|
-
passed: boolean; // Whether the check passed
|
|
12
|
-
suggestion?: string; // Improvement suggestion (present only if failed)
|
|
13
|
-
}[];
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
```
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
# Xquik TypeScript Types: MCP: search-tweets
|
|
2
|
-
|
|
3
|
-
```typescript
|
|
4
|
-
|
|
5
|
-
interface McpSearchResult {
|
|
6
|
-
tweets: {
|
|
7
|
-
id: string; // Tweet ID (use with lookup-tweet for full metrics)
|
|
8
|
-
text: string; // Full tweet text
|
|
9
|
-
authorUsername: string; // X username of the tweet author
|
|
10
|
-
authorName: string; // Display name of the tweet author
|
|
11
|
-
createdAt: string; // ISO 8601 timestamp when tweet was posted
|
|
12
|
-
media?: { mediaUrl: string; type: string; url: string }[]; // Attached photos/videos
|
|
13
|
-
// No engagement metrics. Use lookup-tweet for those
|
|
14
|
-
}[];
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
```
|