x.md

Turn public X posts, conversations, profiles, search results, and social graphs into compact Markdown for agents. The hosted API is available at x.pcstyle.dev; no X API key is required for the default provider path.

Not affiliated with X Corp. Public lists are not available.

• Compact, agent-friendly Markdown by default; add ?full=true for dates, metrics, and richer profile details.
• A source URL for every post and reply, including quoted posts.
• Direct video URLs, thumbnails, duration/dimensions/bitrate when supplied, and all available video variants.
• Conversation context by default: parents, the author's thread, and top replies. Use context and replies to narrow it.
• Structured JSON with the rendered Markdown and raw post/profile data via ?format=json or Accept: application/json.
• Profiles with profile data and up to 20 latest original posts by default.
• Search, followers, and following, with cursor or bounded page pagination.

Replace x.com with x.pcstyle.dev on a public status URL:

https://x.com/handle/status/1234567890
https://x.pcstyle.dev/handle/status/1234567890

curl -sS -H 'Accept: text/markdown' \
  'https://x.pcstyle.dev/handle/status/1234567890'

curl -sS -G 'https://x.pcstyle.dev/api/convert' \
  --data-urlencode 'url=https://x.com/handle/status/1234567890'

Browsers that request HTML get a readable page containing the Markdown. Agents can explicitly request text/markdown. Discord, Telegram, Slack, and other preview bots receive Open Graph embed HTML for the same status URL, including multiple images on Discord, video streams where supported, video thumbnails on Slack, quote/poll text, and an oEmbed engagement line.

Both GET /:handle/status/:id and GET /api/convert?url=… support:

thread=off returns only the requested post. The default conversation result is ordered and labels posts as parent, post, thread, or reply when that data is available. Provider fallbacks can return less context, article content, or quote data.

# Expanded conversation without replies
curl -sS 'https://x.pcstyle.dev/handle/status/1234567890?full=true&replies=off'

# Author thread only, capped at 20 posts
curl -sS 'https://x.pcstyle.dev/handle/status/1234567890?context=thread&thread=20'

# Structured output
curl -sS -H 'Accept: application/json' \
  'https://x.pcstyle.dev/handle/status/1234567890'
curl -sS 'https://x.pcstyle.dev/handle/status/1234567890?format=json'

JSON conversion responses contain url, markdown, raw posts, compact, warnings, postCount, source, cache, and format. Media in both Markdown and posts includes direct video data when the upstream provider exposes it; availability and lifetime of X CDN URLs are controlled by X.

Preview bots hitting GET /:handle/status/:id receive embed HTML instead of Markdown. GET /oembed is the Discord oEmbed document advertised from that HTML. Explicit ?format= or Accept: application/json / text/markdown still wins over user-agent detection.

Browse routes return compact Markdown by default and structured data with ?format=json or Accept: application/json.

The default limit is 20 and the maximum is 50. Pass the opaque cursor returned as nextCursor, or use page=1 through page=10; values above 10 are clamped. Without a cursor, page pagination walks upstream pages and can be slower. A cursor fetches one upstream page. Results can contain fewer items than limit, especially profiles, because replies and reposts are filtered after retrieval.

curl -sS 'https://x.pcstyle.dev/elonmusk'
curl -sS 'https://x.pcstyle.dev/search?q=typescript&feed=latest&limit=20'
curl -sS 'https://x.pcstyle.dev/elonmusk/followers?full=true'
curl -sS -H 'Accept: application/json' \
  'https://x.pcstyle.dev/elonmusk/following?limit=50'

Use resource=profile|search|followers|following, plus the corresponding handle or q:

curl -sS -G 'https://x.pcstyle.dev/api/browse' \
  --data-urlencode 'resource=profile' \
  --data-urlencode 'handle=elonmusk'

curl -sS -G 'https://x.pcstyle.dev/api/browse' \
  --data-urlencode 'resource=search' \
  --data-urlencode 'q=typescript' \
  --data-urlencode 'feed=top' \
  --data-urlencode 'format=json'

Browse JSON includes the resource-specific profile, posts, or users, plus page, limit, optional nextCursor, rendered markdown, and cache status. The verified upstream profile API does not expose pinned-post markers, and public X lists are explicitly unsupported.

Install the hosted skill, browse-x, with the skills CLI:

bunx skills add pc-style/x-md -g -y --skill browse-x

The skill uses https://x.pcstyle.dev; it does not require a local checkout or local API keys.

The skills CLI command follows the repository's current default branch. This project has no tag or release to pin yet, so treat that command as a convenience install: review the copied SKILL.md and script before use. For an immutable audit, inspect commit 146d116a19c93da81a0ae741c19bc3bd74435229 and copy skills/browse-x from that checkout.

FxTwitter is the primary data provider and X's syndication endpoint is the fallback. Self-hosted deployments may additionally configure Context.dev and Firecrawl. X-Source reports fxtwitter, syndication, contextdev, or firecrawl; X-Cache reports cache status. Browse endpoints use FxTwitter directly.

Successful responses are cached for about one hour by default (CACHE_TTL_SECONDS=3600) and send cache headers unless bypassed. nocache=true bypasses the application cache, but it cannot bypass upstream caches. Public X data can be missing, delayed, rate-limited, deleted, protected, or shaped differently by upstream providers, so context, counts, media variants, and pagination cursors are best effort. The API does not authenticate to private accounts and does not provide public lists.

• The hosted service receives the public X URL, handle, or search query you request and sends it to FxTwitter or X's public syndication service. Successful results are cached for about one hour and can be served to other callers requesting the same public resource.
• Optional Context.dev and Firecrawl fallbacks are disabled unless a self-hosted operator configures their API keys. When enabled, the public X URL is sent to that provider.
• The hosted browse-x skill sends its arguments to x.pcstyle.dev. Do not put secrets or private-account information in URLs or search terms.
• Media links point to upstream X/FxTwitter CDNs. Fetching those links is outside x.md's cache and privacy boundary.

x.md is read-only and does not accept X credentials, post content, or account mutations. It is the canonical implementation, has no successor, and is not affiliated with X Corp.

REF=146d116a19c93da81a0ae741c19bc3bd74435229
git init x-md
git -C x-md remote add origin https://github.com/pc-style/x-md.git
git -C x-md fetch --depth 1 origin "$REF"
git -C x-md checkout --detach "$REF"
cd x-md
bun install --frozen-lockfile
cp .env.local.example .env.local
bun run dev

The commit pin and lockfile make this a reviewable source snapshot. No signed image, deployment artifact, tag, or release checksum is published yet; update REF deliberately.

Optional environment variables:

Deploy with Vercel after bun run build; vercel.json configures dist, the API handlers, and all public route rewrites.

api/convert.ts     Post conversion handler
api/browse.ts      Profile, search, followers, and following handler
api/oembed.ts      Discord oEmbed JSON for chat previews
lib/               Providers, rendering, pagination, cache, and embeds
src/               Vite landing page and rendered documentation

MIT