Skip to main content

​
Agent Skill

Install the socq-social-research Skill to teach a coding agent how to choose SocQ endpoints, shape inputs, control cost, and complete asynchronous collections.

​
Skill versus MCP

Use them together when possible. MCP provides execution; the Skill provides endpoint selection, billing awareness, polling, pagination, and cross-platform workflow guidance.

​
What you can ask

The Skill guides the agent through:
  • mapping user intent to a Capability Registry endpoint;
  • choosing URL, username, hashtag, or query inputs;
  • checking schemas and estimating credits before large jobs;
  • submitting with an idempotency key when retries are possible;
  • polling asynchronous tasks instead of resubmitting;
  • following cursor pagination and retrieving raw files;
  • recovering from authentication, validation, rate, credit, and provider errors;
  • coordinating comparable cross-platform research.

​
Execution preference

The Skill prefers:
  1. remote MCP;
  2. the SocQ stdio MCP bridge;
  3. CLI or REST when MCP is unavailable.
Endpoint references are generated from the same Capability Registry as MCP and OpenAPI, so endpoint IDs and input fields remain consistent across integrations.