MCP 서버

Xcatcher — Recent X Posts

io.github.lvpiggyqq/xcatcher

이 MCP로 할 수 있는 일

Crawls recent public X posts by username for monitoring, comparison, OSINT, and research, with task management and structured result retrieval.

cancel_task
Cancel a queued crawl task
Cancel a queued task by task_id. Side effects: changes task state. Xcatcher refunds cost_points when a queued task is successfully cancelled.
파괴적 작업
입력 스키마
{'type': 'object', 'title': 'cancel_taskArguments', 'required': ['task_id'], 'properties': {'task_id': {'type': 'integer', 'title': 'Task Id', 'minimum': 1, 'description': 'Task ID to cancel.'}}}
출력 스키마
{'type': 'object', 'title': 'cancel_taskOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
create_crawl_task
Create an X crawl task
Create a crawl task for one or more X (Twitter) usernames. Side effects: creates a new task AND consumes points. If points are insufficient, upstream returns HTTP 402 with PAYMENT-REQUIRED (quote). This tool surfaces it as error.code=PAYMENT_REQUIRED with payment_required payload so agents can request spending approval, top up, then retry safely. Modes: - normal: Fast latest-post snapshot at scale (fresh-feed monitoring). Optimized for high-throughput batch retrieval. - deep: Deeper per-user collection/enrichment (typically slower; higher resource usage). Use when you need more than a quick latest-post snapshot. Performance note: Normal mode is optimized for a small latest-post snapshot per handle. Actual completeness and latency depend on X availability, upstream limits, and network conditions. Batching: For very large sets, split users into batches. Suggested upper bound per task: 500 users (configurable via MAX_USERS_PER_TASK). Reliability: - Use idempotency_key to make retries safe (avoid duplicate charges). - After creation, poll get_task_status every 5–10s until has_result=true. - Then call get_result_download_url (download still requires the same Bearer token).
파괴적 작업 외부 접근 가능
입력 스키마
{'type': 'object', 'title': 'create_crawl_taskArguments', 'required': ['users'], 'properties': {'mode': {'enum': ['normal', 'deep'], 'type': 'string', 'title': 'Mode', 'default': 'normal', 'description': 'normal = fast latest-post snapshot at scale; deep = deeper per-user collection (slower).'}, 'users': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Users', 'maxItems': 500, 'minItems': 1, 'description': "Array of X usernames (handles). You may include a leading '@'."}, 'idempotency_key': {'anyOf': [{'type': 'string', 'maxLength': 128}, {'type': 'null'}], 'title': 'Idempotency Key', 'default': None, 'description': 'Optional idempotency key for safe retries (recommended for agents).'}}}
출력 스키마
{'type': 'object', 'title': 'create_crawl_taskOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_account_balance
Get Xcatcher balance
Return the account attached to the current Bearer API key and its points balance. Use before creating a task to estimate whether an x402 top-up will be needed. Read-only.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'get_account_balanceArguments', 'properties': {}}
출력 스키마
{'type': 'object', 'title': 'get_account_balanceOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_direct_crawl_payment
Get accountless crawl payment requirements
Create a request-bound x402 v2 payment requirement for an accountless crawl. Use this only for the accountless x402 path after preflight_crawl; API-key accounts use create_crawl_task instead. Normal requests use progressive batch pricing, so quote the complete deduplicated handle list together. This does not move funds. Return payment_required_b64 unchanged to an x402-compatible wallet/client; the live amount, asset, network, destination, and quoteId are authoritative.
외부 접근 가능
입력 스키마
{'type': 'object', 'title': 'get_direct_crawl_paymentArguments', 'required': ['users'], 'properties': {'mode': {'enum': ['normal', 'deep'], 'type': 'string', 'title': 'Mode', 'default': 'normal', 'description': 'Direct x402 normal requests use progressive batch pricing; deep is $0.10 per normalized requested handle. Always preflight the complete list.'}, 'users': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Users', 'maxItems': 500, 'minItems': 1, 'description': 'X handles, @handles, or x.com/twitter.com profile URLs.'}}}
출력 스키마
{'type': 'object', 'title': 'get_direct_crawl_paymentOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_direct_result_preview
Preview accountless paid crawl results
Return structured JSON rows for a completed accountless paid crawl. Use this instead of get_result_preview for an accountless x402 task; API-key accounts use get_result_preview. Use offset for pagination; the task token is required and should be treated as a secret.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'get_direct_result_previewArguments', 'required': ['task_id', 'task_token'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Rows to return (1-100).'}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0, 'minimum': 0, 'description': 'Zero-based row offset.'}, 'task_id': {'type': 'integer', 'title': 'Task Id', 'minimum': 1, 'description': 'Completed paid task ID.'}, 'task_token': {'type': 'string', 'title': 'Task Token', 'description': 'Task-scoped xtask_ token.'}}}
출력 스키마
{'type': 'object', 'title': 'get_direct_result_previewOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_direct_task_status
Get accountless paid task status
Read an accountless paid crawl using its task_id and task-scoped token. Use this instead of get_task_status for an accountless x402 task. Poll every 5-10 seconds until task.has_result is true or it reaches failed/cancelled.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'get_direct_task_statusArguments', 'required': ['task_id', 'task_token'], 'properties': {'task_id': {'type': 'integer', 'title': 'Task Id', 'minimum': 1, 'description': 'Task ID returned after x402 settlement.'}, 'task_token': {'type': 'string', 'title': 'Task Token', 'description': 'Task-scoped xtask_ token returned after settlement or idempotent recovery.'}}}
출력 스키마
{'type': 'object', 'title': 'get_direct_task_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_result_download_url
Get result download URL
Get an absolute download URL for a task result (read-only). If the task is not finished, returns ok=false with code=RESULT_NOT_READY (HTTP 409). Downloading the URL requires the same Authorization: Bearer token.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'get_result_download_urlArguments', 'required': ['task_id'], 'properties': {'task_id': {'type': 'integer', 'title': 'Task Id', 'minimum': 1, 'description': 'Task ID. Must be completed (has_result=true).'}}}
출력 스키마
{'type': 'object', 'title': 'get_result_download_urlOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_result_preview
Preview crawl results
Return up to 100 result rows from an API-key account task as native structured JSON for direct agent analysis; accountless x402 tasks use get_direct_result_preview instead. Use offset/next_offset for pagination; this does not download or parse XLSX. Use after has_result=true; use get_result_download_url when the complete XLSX is required. Read-only.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'get_result_previewArguments', 'required': ['task_id'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum result rows to return (1-100).'}, 'offset': {'type': 'integer', 'title': 'Offset', 'default': 0, 'minimum': 0, 'description': 'Zero-based row offset for pagination.'}, 'task_id': {'type': 'integer', 'title': 'Task Id', 'minimum': 1, 'description': 'Completed task ID owned by the current API key.'}}}
출력 스키마
{'type': 'object', 'title': 'get_result_previewOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_sample_result
Inspect a free Xcatcher sample result
Return a stable synthetic example of Xcatcher's paginated result and coverage metadata. No live X data is fetched, no account is needed, no task or quote is created, and no funds move.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'title': 'get_sample_resultArguments', 'properties': {}}
출력 스키마
{'type': 'object', 'title': 'get_sample_resultOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_service_info
Get Xcatcher service info
Read Xcatcher's live capabilities, prices, limits, endpoints, and recommended agent workflow. Call this first when planning a crawl or when cached documentation may be stale. No points are consumed.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'get_service_infoArguments', 'properties': {}}
출력 스키마
{'type': 'object', 'title': 'get_service_infoOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_task_status
Get crawl task status
Get API-key account task status by task_id (read-only); accountless x402 tasks use get_direct_task_status instead. Recommended polling interval: every 5–10 seconds until has_result=true. Returns safe structured state, result metadata, and authenticated result URLs; server filesystem paths are never exposed.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'get_task_statusArguments', 'required': ['task_id'], 'properties': {'task_id': {'type': 'integer', 'title': 'Task Id', 'minimum': 1, 'description': 'Task ID returned by create_crawl_task.'}}}
출력 스키마
{'type': 'object', 'title': 'get_task_statusOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
get_x402_quote
Get an x402 top-up quote
Create a short-lived USDC quote for a requested number of Xcatcher points. Returns the exact live amount and supported Base/Solana payment requirements; it does not move funds. Ask the user before signing or sending any payment.
외부 접근 가능
입력 스키마
{'type': 'object', 'title': 'get_x402_quoteArguments', 'required': ['points'], 'properties': {'points': {'type': 'integer', 'title': 'Points', 'maximum': 200000, 'minimum': 1, 'description': 'Number of points to buy (1-200000). Live quote amount is authoritative.'}}}
출력 스키마
{'type': 'object', 'title': 'get_x402_quoteOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
list_crawl_tasks
List Xcatcher crawl tasks
List recent tasks owned by the current Bearer API key, newest first. Use next_before_id for cursor pagination. Read-only and does not consume points.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'list_crawl_tasksArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Tasks to return (1-100).'}, 'before_id': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'title': 'Before Id', 'default': None, 'description': 'Cursor from next_before_id; omit for the newest tasks.'}}}
출력 스키마
{'type': 'object', 'title': 'list_crawl_tasksOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
preflight_crawl
Preflight an Xcatcher crawl for free
Normalize and deduplicate X handles, validate the mode, and preview the current modeled points/USDC cost. This free read-only check requires no account, creates no quote or task, and moves no funds. Use it before requesting a live x402 payment challenge.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'title': 'preflight_crawlArguments', 'required': ['users'], 'properties': {'mode': {'enum': ['normal', 'deep'], 'type': 'string', 'title': 'Mode', 'default': 'normal', 'description': 'API-key accounts use 1 point per normal handle and 10 per deep handle; direct x402 normal requests receive progressive batch pricing shown by preflight.'}, 'users': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Users', 'maxItems': 500, 'minItems': 1, 'description': 'X handles, @handles, or x.com/twitter.com profile URLs.'}}}
출력 스키마
{'type': 'object', 'title': 'preflight_crawlOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
submit_direct_crawl_payment
Pay for and create an accountless crawl
Submit an x402 v2 PAYMENT-SIGNATURE for the exact users/mode used by get_direct_crawl_payment. This may settle USDC and create a crawl task. Call only after explicit spending approval. On success, securely save task_token: it grants task-scoped result access for seven days.
파괴적 작업 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', 'title': 'submit_direct_crawl_paymentArguments', 'required': ['users', 'payment_signature_b64'], 'properties': {'mode': {'enum': ['normal', 'deep'], 'type': 'string', 'title': 'Mode', 'default': 'normal', 'description': 'Must exactly match the quoted mode.'}, 'users': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Users', 'maxItems': 500, 'minItems': 1, 'description': 'The exact handles/profile URLs used for the payment requirement.'}, 'payment_signature_b64': {'type': 'string', 'title': 'Payment Signature B64', 'description': 'The base64(JSON) PAYMENT-SIGNATURE produced for the accepted x402 v2 requirement.'}}}
출력 스키마
{'type': 'object', 'title': 'submit_direct_crawl_paymentOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
wait_for_task
Wait for a crawl task
Poll a crawl task server-side until it has a result, reaches a terminal failure/cancelled state, or the bounded timeout expires. Read-only and cheaper for agent context than repeated manual polling.
읽기 전용
입력 스키마
{'type': 'object', 'title': 'wait_for_taskArguments', 'required': ['task_id'], 'properties': {'task_id': {'type': 'integer', 'title': 'Task Id', 'minimum': 1, 'description': 'Task ID returned by create_crawl_task.'}, 'timeout_seconds': {'type': 'integer', 'title': 'Timeout Seconds', 'default': 60, 'maximum': 120, 'minimum': 5, 'description': 'Maximum wait in seconds (5-120).'}, 'poll_interval_seconds': {'type': 'integer', 'title': 'Poll Interval Seconds', 'default': 5, 'maximum': 15, 'minimum': 2, 'description': 'Seconds between status checks (2-15).'}}}
출력 스키마
{'type': 'object', 'title': 'wait_for_taskOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
x402_topup
Credit points from an x402 payment
Top up points for the CURRENT Bearer key using x402 proof. Inputs: - quote_id: returned by PAYMENT-REQUIRED (or /api/v1/x402/quote) - payment_signature_b64: base64(JSON) that will be passed as HTTP header PAYMENT-SIGNATURE Side effects: credits points to the same Bearer key (no key rotation). On success returns credited_points and balance_after (shape depends on upstream).
파괴적 작업 외부 접근 가능 멱등성
입력 스키마
{'type': 'object', 'title': 'x402_topupArguments', 'required': ['quote_id', 'payment_signature_b64'], 'properties': {'quote_id': {'type': 'string', 'title': 'Quote Id', 'description': 'Quote ID returned by PAYMENT-REQUIRED (or /x402/quote).'}, 'payment_signature_b64': {'type': 'string', 'title': 'Payment Signature B64', 'description': 'Base64(JSON) for header PAYMENT-SIGNATURE.'}}}
출력 스키마
{'type': 'object', 'title': 'x402_topupOutput', 'required': ['result'], 'properties': {'result': {'type': 'object', 'title': 'Result', 'additionalProperties': True}}}
추가됨
cancel_task
2026년 9월 17일 12:43 PM
추가됨
get_result_download_url
2026년 9월 17일 12:43 PM
추가됨
get_result_preview
2026년 9월 17일 12:43 PM
추가됨
wait_for_task
2026년 9월 17일 12:43 PM
추가됨
get_task_status
2026년 9월 17일 12:43 PM
추가됨
x402_topup
2026년 9월 17일 12:43 PM
추가됨
create_crawl_task
2026년 9월 17일 12:43 PM
추가됨
get_direct_result_preview
2026년 9월 17일 12:43 PM
추가됨
get_direct_task_status
2026년 9월 17일 12:43 PM
추가됨
submit_direct_crawl_payment
2026년 9월 17일 12:43 PM
추가됨
get_direct_crawl_payment
2026년 9월 17일 12:43 PM
추가됨
get_x402_quote
2026년 9월 17일 12:43 PM
추가됨
list_crawl_tasks
2026년 9월 17일 12:43 PM
추가됨
get_account_balance
2026년 9월 17일 12:43 PM
추가됨
get_sample_result
2026년 9월 17일 12:43 PM
추가됨
preflight_crawl
2026년 9월 17일 12:43 PM
추가됨
get_service_info
2026년 9월 17일 12:43 PM