x-developer 2.6.5 → 2.6.7

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

@@ -1,30 +1,19 @@
-# Xquik TypeScript Types: Extractions
+# Xquik TypeScript types: extractions
 
 ```typescript
 
 type ExtractionToolType =
-  | "article_extractor"
-  | "community_extractor"
-  | "community_moderator_explorer"
-  | "community_post_extractor"
-  | "community_search"
-  | "favoriters"
-  | "follower_explorer"
-  | "following_explorer"
-  | "list_follower_explorer"
-  | "list_member_extractor"
-  | "list_post_extractor"
-  | "mention_extractor"
-  | "people_search"
-  | "post_extractor"
-  | "quote_extractor"
-  | "reply_extractor"
-  | "repost_extractor"
-  | "space_explorer"
-  | "thread_extractor"
-  | "tweet_search_extractor"
-  | "user_likes"
-  | "user_media"
+  | "article_extractor" | "community_extractor"
+  | "community_moderator_explorer" | "community_post_extractor"
+  | "community_search" | "favoriters"
+  | "follower_explorer" | "following_explorer"
+  | "list_follower_explorer" | "list_member_extractor"
+  | "list_post_extractor" | "mention_extractor"
+  | "people_search" | "post_extractor"
+  | "quote_extractor" | "reply_extractor"
+  | "repost_extractor" | "space_explorer"
+  | "thread_extractor" | "tweet_search_extractor"
+  | "user_likes" | "user_media"
   | "verified_follower_explorer";
 
 interface ExtractionJob {
@@ -32,13 +21,10 @@ interface ExtractionJob {
   toolType: ExtractionToolType;
   status: "pending" | "running" | "completed" | "failed";
   totalResults: number;
-  targetTweetId?: string;
-  targetUsername?: string;
-  targetCommunityId?: string;
-  targetListId?: string;
-  targetSpaceId?: string;
-  searchQuery?: string;
-  resultsLimit?: number; // Max results to extract. Stops early instead of fetching all. Omit for all.
+  targetTweetId?: string; targetUsername?: string;
+  targetCommunityId?: string; targetListId?: string;
+  targetSpaceId?: string; searchQuery?: string;
+  resultsLimit?: number; // Maximum results. Omit to request all available results.
   errorMessage?: string;
   createdAt: string;
   completedAt?: string;
@@ -46,15 +32,10 @@ interface ExtractionJob {
 
 interface ExtractionResult {
   id: string;
-  xUserId: string;
-  xUsername?: string;
-  xDisplayName?: string;
-  xFollowersCount?: number;
-  xVerified?: boolean;
+  xUserId: string; xUsername?: string; xDisplayName?: string;
+  xFollowersCount?: number; xVerified?: boolean;
   xProfileImageUrl?: string;
-  tweetId?: string;
-  tweetText?: string;
-  tweetCreatedAt?: string;
+  tweetId?: string; tweetText?: string; tweetCreatedAt?: string;
   createdAt: string;
 }
 
@@ -65,52 +46,66 @@ interface ExtractionList {
 }
 
 interface ExtractionEstimate {
-  allowed: boolean;
-  creditsAvailable: string;
-  creditsRequired: string;
+  allowed: boolean; estimatedResults: number;
+  creditsAvailable: string; creditsRequired: string;
   source: "replyCount" | "retweetCount" | "quoteCount" | "followers" | "unknown";
-  estimatedResults: number;
-  resolvedXUserId?: string;
-  error?: string;
+  resolvedXUserId?: string; error?: string;
+}
+
+type ExtractionMixedTarget = string | {
+  kind: "favoriters" | "list" | "profile" | "profile_likes" | "profile_media" |
+    "profile_replies" | "quotes" | "replies" | "retweeters" | "search" |
+    "thread" | "tweet";
+  value: string;
+};
+
+interface ExtractionRelationTarget {
+  relation: "community_members" | "followers" | "following" |
+    "list_followers" | "list_members" | "verified_followers";
+  value: string;
 }
 
 interface CreateExtractionRequest {
   toolType: ExtractionToolType;
-  targetTweetId?: string;
-  targetUsername?: string;
-  targetCommunityId?: string;
-  targetListId?: string;
+  targetTweetId?: string; targetTweetIds?: string[];
+  targetUsername?: string; targetUsernames?: string[];
+  targetCommunityId?: string; targetCommunityIds?: string[];
+  targetListId?: string; targetListIds?: string[];
   targetSpaceId?: string;
-  searchQuery?: string;
-  resultsLimit?: number; // Max results to extract. Stops early instead of fetching all. Omit for all.
-  // Tweet search filters (tweet_search_extractor only)
-  fromUser?: string;
-  toUser?: string;
-  mentioning?: string;
+  searchQuery?: string; searchQueries?: string[];
+  targets?: ExtractionMixedTarget[];
+  relationTargets?: ExtractionRelationTarget[];
+  resultsLimit?: number; // Maximum results. Omit to request all available results.
+  queryType?: "Latest" | "Top" | "Both";
+  maxItemsPerTarget?: number; maxPagesPerTarget?: number;
+  startCursor?: string;
+  dedupeAcrossTargets?: boolean;
+  dedupeMode?: "none" | "first" | "merge";
+  overlapMode?: boolean;
+  includeSearchTerms?: boolean; includeTargetMetadata?: boolean;
+  collectionStrategy?: "auto" | "complete" | "direct" | "search" | "thread";
+  scope?: "all" | "direct" | "nested";
+  maxDepth?: number;
+  sort?: "relevance" | "latest" | "oldest" | "likes";
+  excludeOriginalAuthor?: boolean; includeOriginalPost?: boolean;
+  hasMediaOnly?: boolean;
+  sinceTime?: string | number; untilTime?: string | number;
+  // Used only by tweet_search_extractor.
+  fromUser?: string; toUser?: string; mentioning?: string;
   language?: string;
-  sinceDate?: string;           // YYYY-MM-DD
-  untilDate?: string;           // YYYY-MM-DD
+  sinceDate?: string; untilDate?: string; // YYYY-MM-DD
   mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
-  minFaves?: number;
-  minRetweets?: number;
-  minReplies?: number;
-  minQuotes?: number;
-  minViews?: number;
-  minBookmarks?: number;
-  maxLikes?: number;
-  maxRetweets?: number;
-  maxReplies?: number;
-  maxQuotes?: number;
+  minFaves?: number; minRetweets?: number;
+  minReplies?: number; minQuotes?: number;
+  minViews?: number; minBookmarks?: number;
+  maxLikes?: number; maxRetweets?: number;
+  maxReplies?: number; maxQuotes?: number;
   blueVerifiedOnly?: boolean;
   cardName?: string;
-  source?: string;
-  excludeSource?: string;
+  source?: string; excludeSource?: string;
   geocode?: string;
-  sinceId?: string;
-  maxId?: string;
-  near?: string;
-  within?: string;
-  withinTime?: string;
+  sinceId?: string; maxId?: string;
+  near?: string; within?: string; withinTime?: string;
   nativeRetweets?: boolean;
   safe?: boolean;
   news?: boolean;
@@ -118,36 +113,24 @@ interface CreateExtractionRequest {
   replies?: 'include' | 'exclude' | 'only';
   retweets?: 'include' | 'exclude' | 'only';
   quotes?: 'include' | 'exclude' | 'only';
-  exactPhrase?: string;
-  excludeWords?: string;
-  anyWords?: string;
-  hashtags?: string;
-  cashtags?: string;
+  exactPhrase?: string; excludeWords?: string; anyWords?: string;
+  hashtags?: string; cashtags?: string;
   url?: string;
-  conversationId?: string;
-  inReplyToTweetId?: string;
-  quotesOfTweetId?: string;
-  retweetsOfTweetId?: string;
+  conversationId?: string; inReplyToTweetId?: string;
+  quotesOfTweetId?: string; retweetsOfTweetId?: string;
   listId?: string;
-  place?: string;
-  placeCountry?: string;
-  pointRadius?: string;
-  boundingBox?: string;
+  place?: string; placeCountry?: string;
+  pointRadius?: string; boundingBox?: string;
   advancedQuery?: string;
-  // Profile filters for profile-producing extractions
-  minFollowers?: number;
-  maxFollowers?: number;
-  minFollowing?: number;
-  maxFollowing?: number;
-  minPosts?: number;
-  maxPosts?: number;
+  // Filters for extractions that return profiles.
+  minFollowers?: number; maxFollowers?: number;
+  minFollowing?: number; maxFollowing?: number;
+  minPosts?: number; maxPosts?: number;
   minAccountAgeDays?: number;
   verifiedType?: string;
   hasWebsite?: boolean;
   hasLocation?: boolean;
-  bioContains?: string;
-  locationContains?: string;
-  usernameContains?: string;
+  bioContains?: string; locationContains?: string; usernameContains?: string;
 }
 
 ```

package/skills/x-twitter-scraper/references/types-mcp-output-schemas.md

@@ -1,4 +1,4 @@
-# Xquik MCP Output Schemas
+# Xquik MCP output schemas
 
 Hosted MCP exposes 2 tools: `explore` and `xquik`. It does not expose legacy
 operation-named tools such as `search-tweets` or `get-events`.

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Monitors
+# Xquik TypeScript types: monitors
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Radar
+# Xquik TypeScript types: radar
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Request Bodies
+# Xquik TypeScript types: request bodies
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik REST API and MCP Field Naming
+# Xquik REST API and MCP field naming
 
 Hosted MCP exposes `explore` and `xquik`. It no longer exposes
 operation-named tools with separate legacy response models.

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Support
+# Xquik TypeScript types: support
 
 ```typescript
 type SupportTicketStatus = "open" | "in_progress" | "resolved" | "closed";

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Trends
+# Xquik TypeScript types: trends
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Tweet Drafts
+# Xquik TypeScript types: tweet drafts
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Tweet Style Cache
+# Xquik TypeScript types: tweet style cache
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: User Activity
+# Xquik TypeScript types: user activity
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: Webhooks
+# Xquik TypeScript types: webhooks
 
 ```typescript
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: X Accounts (Connected)
+# Xquik TypeScript types: connected X accounts
 
 ```typescript
 
@@ -10,7 +10,7 @@ interface ConnectedXAccount {
   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.
+// Users connect X accounts in the Xquik dashboard.
+// This Skill never handles X login material.
 
 ```

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: X API
+# Xquik TypeScript types: X API
 
 ```typescript
 
@@ -6,22 +6,22 @@ interface TweetMediaItem {
   mediaUrl: string;
   type: string;       // "photo" | "video" | "animated_gif"
   url: string;
-  allowDownload?: boolean;
-  altText?: string;
-  aspectRatio?: number[];
-  availabilityStatus?: string;
-  displayUrl?: string;
-  durationMillis?: number;
-  expandedUrl?: string;
-  faceRects?: Record<string, unknown>;
-  focusRects?: Array<Record<string, number>>;
-  height?: number;
-  id?: string;
+  adultContent?: boolean; allowDownload?: boolean;
+  altText?: string; availabilityReason?: string;
+  aspectRatio?: number[]; availabilityStatus?: string;
+  description?: string; displayUrl?: string;
+  durationMillis?: number; expandedUrl?: string;
+  embeddable?: boolean;
+  faceRects?: Record<string, unknown>; focusRects?: Array<Record<string, number>>;
+  grokPostId?: string; height?: number; id?: string;
   indices?: number[];
-  mediaKey?: string;
-  monetizable?: boolean;
+  mediaKey?: string; monetizable?: boolean;
   sizes?: Record<string, unknown>;
+  sourceStatusId?: string; sourceUserId?: string;
+  tags?: Array<Record<string, string>>;
+  title?: string;
   videoVariants?: Array<Record<string, unknown>>;
+  watchNowUrl?: string; visitSiteUrl?: string;
   width?: number;
 }
 
@@ -51,20 +51,20 @@ interface Tweet {
 
 interface ProfileRichness {
   affiliatesHighlightedLabel?: Record<string, unknown>;
-  businessAccountAffiliatesCount?: number;
-  creatorSubscriptionsCount?: number;
+  businessAccountAffiliatesCount?: number; creatorSubscriptionsCount?: number;
   hasGraduatedAccess?: boolean;
   hasHiddenSubscriptionsOnProfile?: boolean;
-  highlightsInfo?: Record<string, unknown>;
-  identityVerification?: Record<string, unknown>;
+  highlightsInfo?: Record<string, unknown>; identityVerification?: Record<string, unknown>;
   isProfileTranslatable?: boolean;
   parodyCommentaryFanLabel?: string;
-  profileDescriptionLanguage?: string;
-  profileImageShape?: string;
-  profileInterstitialType?: string;
-  profileSortEnabled?: boolean;
+  profileDescriptionLanguage?: string; profileImageShape?: string;
+  profileInterstitialType?: string; profileSortEnabled?: boolean;
   profileTranslatorType?: string;
   superFollowEligible?: boolean;
+  withheldScope?: string; professional?: Record<string, unknown>;
+  grokTranslatedBio?: Record<string, unknown>;
+  superFollowsUserProfileActive?: boolean;
+  tipJar?: Record<string, unknown>;
 }
 
 interface TweetAuthor extends ProfileRichness {
@@ -88,16 +88,10 @@ interface TweetSearchResult {
 }
 
 interface UserProfile extends ProfileRichness {
-  id: string;
-  username: string;
-  name: string;
+  id: string; username: string; name: string;
   description?: string;
-  followers?: number;
-  following?: number;
-  verified?: boolean;
-  profilePicture?: string;
-  location?: string;
-  createdAt?: string;
+  followers?: number; following?: number; verified?: boolean;
+  profilePicture?: string; location?: string; createdAt?: string;
   statusesCount?: number;
 }
 

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

@@ -1,4 +1,4 @@
-# Xquik TypeScript Types: X Articles
+# Xquik TypeScript types: X Articles
 
 ```typescript
 interface ArticleResponse {

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

@@ -1,13 +1,13 @@
-# Xquik TypeScript Types: X Write
+# 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)
+  text?: string;              // Required tweet text unless media is provided.
   reply_to_tweet_id?: string; // Tweet ID to reply to
   community_id?: string;      // Community ID to post into
-  is_note_tweet?: boolean;    // Long-form note tweet (up to 25,000 chars)
+  is_note_tweet?: boolean;    // Long-form note tweet up to 25,000 characters.
   media?: string[];           // Up to 4 images or exactly 1 MP4 URL
 }
 

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

@@ -1,31 +1,31 @@
-# Xquik TypeScript Type Definitions
+# Xquik TypeScript type definitions
 
-Routing index for TypeScript response and request shapes. Load only the type section needed for the user task.
+Use this index to load only the TypeScript types needed for the task.
 
 | Need | Reference |
 |---|---|
 | Account | [account.md](types-account.md) |
 | Credits | [credits.md](types-credits.md) |
-| API Keys | [api-keys.md](types-api-keys.md) |
+| API keys | [api-keys.md](types-api-keys.md) |
 | Monitors | [monitors.md](types-monitors.md) |
 | Events | [events.md](types-events.md) |
 | Webhooks | [webhooks.md](types-webhooks.md) |
 | Draws | [draws.md](types-draws.md) |
 | Extractions | [extractions.md](types-extractions.md) |
 | X API | [x-api.md](types-x-api.md) |
-| User Activity | [user-activity.md](types-user-activity.md) |
-| Bookmarks & Timeline | [bookmarks-and-timeline.md](types-bookmarks-and-timeline.md) |
-| X Articles | [x-articles.md](types-x-articles.md) |
+| User activity | [user-activity.md](types-user-activity.md) |
+| Bookmarks and timeline | [bookmarks-and-timeline.md](types-bookmarks-and-timeline.md) |
+| X articles | [x-articles.md](types-x-articles.md) |
 | Radar | [radar.md](types-radar.md) |
-| Download Media | [download-media.md](types-download-media.md) |
+| Download media | [download-media.md](types-download-media.md) |
 | Trends | [trends.md](types-trends.md) |
 | Support | [support.md](types-support.md) |
 | Error | [error.md](types-error.md) |
-| Request Bodies | [request-bodies.md](types-request-bodies.md) |
-| Tweet Style Cache | [tweet-style-cache.md](types-tweet-style-cache.md) |
-| Tweet Drafts | [tweet-drafts.md](types-tweet-drafts.md) |
-| Account Identity | [account-identity.md](types-account-identity.md) |
-| REST API vs MCP Field Naming | [rest-api-vs-mcp-field-naming.md](types-rest-api-vs-mcp-field-naming.md) |
-| MCP Output Schemas | [mcp-output-schemas.md](types-mcp-output-schemas.md) |
-| X Accounts (Connected) | [x-accounts.md](types-x-accounts.md) |
-| X Write | [x-write.md](types-x-write.md) |
+| Request bodies | [request-bodies.md](types-request-bodies.md) |
+| Tweet style cache | [tweet-style-cache.md](types-tweet-style-cache.md) |
+| Tweet drafts | [tweet-drafts.md](types-tweet-drafts.md) |
+| Account identity | [account-identity.md](types-account-identity.md) |
+| REST API and MCP field naming | [rest-api-vs-mcp-field-naming.md](types-rest-api-vs-mcp-field-naming.md) |
+| MCP output schemas | [mcp-output-schemas.md](types-mcp-output-schemas.md) |
+| Connected X accounts | [x-accounts.md](types-x-accounts.md) |
+| X writes | [x-write.md](types-x-write.md) |

package/skills/x-twitter-scraper/references/usage.md

@@ -1,8 +1,8 @@
-# Xquik Usage Guardrails
+# Xquik usage and approval rules
 
-Use this reference to keep Xquik calls bounded, consent-based, and account-safe. Agents can read the current balance and request estimates so users can decide what to run.
+Use this reference to bound Xquik calls and require approval. Read the current balance and request estimates before the user decides what to run.
 
-## Agent Scope
+## Agent scope
 
 The skill may:
 
@@ -21,7 +21,7 @@ The skill must not:
 
 Plan and credit changes are dashboard-only.
 
-## Before Metered Work
+## Before metered work
 
 Before creating extraction jobs, draws, monitors, signed event delivery, or write actions:
 
@@ -31,13 +31,13 @@ Before creating extraction jobs, draws, monitors, signed event delivery, or writ
 4. Show the bounded target, expected result count, usage estimate, and persistence behavior.
 5. Wait for explicit user approval before sending the request.
 
-## Balance Reads
+## Balance reads
 
 Use `GET /credits` to read the current balance and account state. Treat returned plan and credit-change fields as read-only status from the dashboard.
 
 Do not use balance data to decide whether to run work automatically. Ask the user when a request may consume credits, create persistent resources, or act on an account.
 
-## Persistent Usage
+## Persistent usage
 
 Monitors and signed event delivery can continue after the current chat. Before creating one, show: