x-developer 2.4.13 → 2.5.0

package/skills/x-twitter-scraper/references/types-radar.md

@@ -0,0 +1,40 @@
+# Xquik TypeScript Types: Radar
+
+```typescript
+
+type RadarSource =
+  | "github"
+  | "google_trends"
+  | "hacker_news"
+  | "polymarket"
+  | "reddit"
+  | "wikipedia";
+
+type RadarCategory =
+  | "general"
+  | "tech"
+  | "dev"
+  | "science"
+  | "culture"
+  | "politics"
+  | "business"
+  | "entertainment";
+
+interface RadarItem {
+  id: string;
+  title: string;
+  description?: string;
+  url?: string;
+  imageUrl?: string;
+  source: RadarSource;
+  sourceId: string;
+  category: RadarCategory;
+  region: string;
+  language: string;
+  score: number;
+  metadata: Record<string, unknown>;
+  publishedAt: string;
+  createdAt: string;
+}
+
+```

package/skills/x-twitter-scraper/references/types-request-bodies.md

@@ -0,0 +1,30 @@
+# Xquik TypeScript Types: Request Bodies
+
+```typescript
+
+interface CreateMonitorRequest {
+  username: string;
+  eventTypes: EventType[];
+}
+
+interface UpdateMonitorRequest {
+  eventTypes?: EventType[];
+  isActive?: boolean;
+}
+
+interface CreateWebhookRequest {
+  url: string;
+  eventTypes: EventType[];
+}
+
+interface UpdateWebhookRequest {
+  url?: string;
+  eventTypes?: EventType[];
+  isActive?: boolean;
+}
+
+interface CreateApiKeyRequest {
+  name?: string;
+}
+
+```

package/skills/x-twitter-scraper/references/types-rest-api-vs-mcp-field-naming.md

@@ -0,0 +1,15 @@
+# Xquik TypeScript Types: REST API vs MCP Field Naming
+
+The REST API and MCP server use different field names for the same data. Map these when switching between interfaces:
+
+| Type | REST API Field | MCP Field |
+|------|---------------|-----------|
+| **Monitor** | `username` | `xUsername` |
+| **XquikEvent** | `type` | `eventType` |
+| **XquikEvent** | `data` | `eventData` |
+| **XquikEvent** | `monitorId` | `monitoredAccountId` |
+| **UserProfile** | `followers` | `followersCount` |
+| **UserProfile** | `following` | `followingCount` |
+| **FollowerCheck** | `isFollowing` / `isFollowedBy` | `following` / `followedBy` |
+
+**MCP `get-user-info` returns a subset** of the full `UserProfile` type. Fields not returned by MCP: `verified`, `location`, `createdAt`, `statusesCount`. Use the REST API `GET /x/users/{id}` for the complete profile.

package/skills/x-twitter-scraper/references/types-support.md

@@ -0,0 +1,25 @@
+# Xquik TypeScript Types: Support
+
+```typescript
+
+interface SupportTicket {
+  id: string;
+  subject: string;
+  status: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface SupportMessage {
+  id: string;
+  body: string;
+  sender: string;
+  createdAt: string;
+}
+
+interface CreateTicketRequest {
+  subject: string;
+  body: string;
+}
+
+```

package/skills/x-twitter-scraper/references/types-trends.md

@@ -0,0 +1,18 @@
+# Xquik TypeScript Types: Trends
+
+```typescript
+
+interface Trend {
+  name: string;
+  description?: string;
+  rank?: number;
+  query?: string;
+}
+
+interface TrendList {
+  trends: Trend[];
+  total: number;
+  woeid: number;
+}
+
+```

package/skills/x-twitter-scraper/references/types-tweet-drafts.md

@@ -0,0 +1,20 @@
+# Xquik TypeScript Types: Tweet Drafts
+
+```typescript
+
+interface TweetDraft {
+  id: string;
+  text: string;
+  topic?: string;
+  goal?: "engagement" | "followers" | "authority" | "conversation";
+  createdAt: string; // ISO 8601
+  updatedAt: string; // ISO 8601
+}
+
+interface TweetDraftList {
+  drafts: TweetDraft[];
+  afterCursor: string | null;
+  hasMore: boolean;
+}
+
+```

package/skills/x-twitter-scraper/references/types-tweet-style-cache.md

@@ -0,0 +1,50 @@
+# Xquik TypeScript Types: Tweet Style Cache
+
+```typescript
+
+interface TweetStyleCache {
+  xUsername: string;
+  tweetCount: number;
+  isOwnAccount: boolean;
+  fetchedAt: string; // ISO 8601
+  tweets: CachedTweet[];
+}
+
+interface CachedTweet {
+  id: string;
+  text: string;
+  authorUsername: string;
+  createdAt: string; // ISO 8601
+  media?: TweetMediaItem[];
+}
+
+interface TweetStyleSummary {
+  xUsername: string;
+  tweetCount: number;
+  isOwnAccount: boolean;
+  fetchedAt: string;
+}
+
+interface StyleComparison {
+  style1: TweetStyleCache;
+  style2: TweetStyleCache;
+}
+
+interface StylePerformance {
+  xUsername: string;
+  tweetCount: number;
+  tweets: PerformanceTweet[];
+}
+
+interface PerformanceTweet {
+  id: string;
+  text: string;
+  likeCount: number;
+  retweetCount: number;
+  replyCount: number;
+  quoteCount: number;
+  viewCount: number;
+  bookmarkCount: number;
+}
+
+```

package/skills/x-twitter-scraper/references/types-user-activity.md

@@ -0,0 +1,35 @@
+# Xquik TypeScript Types: User Activity
+
+```typescript
+
+interface UserTweetsResponse {
+  tweets: Tweet[];
+  has_next_page: boolean;
+  next_cursor?: string;
+}
+
+interface UserLikesResponse {
+  tweets: Tweet[];
+  has_next_page: boolean;
+  next_cursor?: string;
+}
+
+interface UserMediaResponse {
+  tweets: Tweet[];
+  has_next_page: boolean;
+  next_cursor?: string;
+}
+
+interface TweetFavoritersResponse {
+  users: UserProfile[];
+  has_next_page: boolean;
+  next_cursor?: string;
+}
+
+interface FollowersYouKnowResponse {
+  users: UserProfile[];
+  has_next_page: boolean;
+  next_cursor?: string;
+}
+
+```

package/skills/x-twitter-scraper/references/types-webhooks.md

@@ -0,0 +1,38 @@
+# Xquik TypeScript Types: Webhooks
+
+```typescript
+
+interface WebhookCreated {
+  id: string;
+  url: string;
+  eventTypes: EventType[];
+  secret: string;
+  createdAt: string;
+}
+
+interface Webhook {
+  id: string;
+  url: string;
+  eventTypes: EventType[];
+  isActive: boolean;
+  createdAt: string;
+}
+
+interface Delivery {
+  id: string;
+  streamEventId: string;
+  status: "pending" | "delivered" | "failed" | "exhausted";
+  attempts: number;
+  lastStatusCode?: number;
+  lastError?: string;
+  createdAt: string;
+  deliveredAt?: string;
+}
+
+interface WebhookPayload {
+  eventType: EventType;
+  username: string;
+  data: EventData;
+}
+
+```

package/skills/x-twitter-scraper/references/types-x-accounts.md

@@ -0,0 +1,16 @@
+# Xquik TypeScript Types: X Accounts (Connected)
+
+```typescript
+
+interface ConnectedXAccount {
+  id: string;                 // Unique account ID
+  username: string;           // X username
+  displayName?: string;       // Display name on X
+  isActive: boolean;          // Whether the connection is active
+  createdAt: string;          // ISO 8601 timestamp
+}
+
+// Connecting an X account is done by the user in the Xquik dashboard,
+// not through this skill. The skill never handles X login material.
+
+```

package/skills/x-twitter-scraper/references/types-x-api.md

@@ -0,0 +1,69 @@
+# Xquik TypeScript Types: X API
+
+```typescript
+
+interface TweetMediaItem {
+  mediaUrl: string;
+  type: string;       // "photo" | "video" | "animated_gif"
+  url: string;
+}
+
+interface Tweet {
+  id: string;
+  text: string;
+  createdAt?: string;
+  retweetCount: number;
+  replyCount: number;
+  likeCount: number;
+  quoteCount: number;
+  viewCount: number;
+  bookmarkCount: number;
+  media?: TweetMediaItem[];
+}
+
+interface TweetAuthor {
+  id: string;
+  username: string;
+  followers: number;
+  verified: boolean;
+  profilePicture?: string;
+}
+
+interface TweetSearchResult {
+  id: string;
+  text: string;
+  createdAt: string;
+  likeCount: number;    // Omitted if unavailable
+  retweetCount: number; // Omitted if unavailable
+  replyCount: number;   // Omitted if unavailable
+  media?: TweetMediaItem[];
+  author: {
+    id: string;
+    username: string;
+    name: string;
+    verified: boolean;
+  };
+}
+
+interface UserProfile {
+  id: string;
+  username: string;
+  name: string;
+  description?: string;
+  followers?: number;
+  following?: number;
+  verified?: boolean;
+  profilePicture?: string;
+  location?: string;
+  createdAt?: string;
+  statusesCount?: number;
+}
+
+interface FollowerCheck {
+  sourceUsername: string;
+  targetUsername: string;
+  isFollowing: boolean;
+  isFollowedBy: boolean;
+}
+
+```

package/skills/x-twitter-scraper/references/types-x-articles.md

@@ -0,0 +1,21 @@
+# Xquik TypeScript Types: X Articles
+
+```typescript
+
+interface Article {
+  title: string;
+  coverImage?: string;
+  bodyHtml: string;
+  likeCount: number;
+  retweetCount: number;
+  replyCount: number;
+  viewCount: number;
+  bookmarkCount: number;
+  author: {
+    id: string;
+    username: string;
+    name: string;
+  };
+}
+
+```

package/skills/x-twitter-scraper/references/types-x-write.md

@@ -0,0 +1,39 @@
+# Xquik TypeScript Types: X Write
+
+```typescript
+
+interface CreateTweetRequest {
+  account: string;            // Connected X username or account ID
+  text?: string;              // Tweet text (required unless media is provided)
+  reply_to_tweet_id?: string; // Tweet ID to reply to
+  attachment_url?: string;    // URL to attach as card
+  community_id?: string;      // Community ID to post into
+  is_note_tweet?: boolean;    // Long-form note tweet (up to 25,000 chars)
+  media?: string[];           // Public image URLs, such as mediaUrl from POST /x/media
+}
+
+interface CreateTweetResponse {
+  tweetId: string;            // ID of the newly created tweet
+  success: boolean;           // Always true on success
+}
+
+interface WriteActionRequest {
+  account: string;            // Connected X username or account ID
+}
+
+interface SendDmRequest {
+  account: string;            // Connected X username or account ID
+  text: string;               // Message text
+  media_ids?: string[];       // Media IDs to attach
+  reply_to_message_id?: string; // Message ID to reply to
+}
+
+interface UpdateProfileRequest {
+  account: string;            // Connected X username or account ID
+  name?: string;              // Display name
+  description?: string;       // Bio
+  location?: string;          // Location
+  url?: string;               // Website URL
+}
+
+```