mcpField
B
browse-x

browse-x

github.com/pc-styleProductivity16877 installsUpdated today
Repository

About browse-x

browse-x is a skill for retrieving public X content when browser access or an X login is unavailable. It returns Markdown or structured data through a command-line helper, does not write to X, and reports limitations that may affect results.

Key features

  1. 01Reads public posts and articles
  2. 02Views profiles and original posts
  3. 03Checks followers and following
  4. 04Searches public X content
  5. 05Outputs Markdown or JSON

Use cases

  1. 01Read X links found in documents
  2. 02Review a public account's bio and recent posts
  3. 03Save post content to notes
  4. 04Retrieve X search results as data

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pc-style/x-md --skill browse-x

After installing, type/browse-xin Claude Code to confirm it loaded.

Bundled filesscripts/browse-x.tstests/browse-x.test.ts

Details

From the project README

browse x

public content through mdfromx.com. no X login needed. run the helper from this skill's directory:

when to use this

reach for it whenever the job is reading one piece of public X content right now:

  • you need the text of a public X post, thread, or X Article and can't run a browser or log into X.
  • you hit an x.com, twitter.com, or t.co link in a document, issue, changelog, or chat log and need its content inline.
  • you want a public profile's bio and latest original posts (replies and reposts filtered out).
  • you're checking who a public account follows, or who follows it.
  • you want X search results as data rather than a rendered timeline.
  • you're saving a post into notes or a vault — --format obsidian emits YAML frontmatter.

when not to use this

  • anything that writes. it never posts, replies, follows, likes, bookmarks, or sends DMs, and takes no X credentials.
  • private, protected, suspended, or deleted accounts and posts. never available; no flag unlocks them.
  • X Lists, DMs, notifications, the personalized home timeline, account analytics. not supported.
  • bulk collection, backfills, or dataset building. it's rate limited and cached for one question at a time.
  • anything needing guaranteed completeness or an SLA. results come from public upstream providers and can lag or truncate — read warnings instead of assuming.
bun scripts/browse-x.ts "https://x.com/handle/status/123"
bun scripts/browse-x.ts profile handle
bun scripts/browse-x.ts search "from:handle release"
bun scripts/browse-x.ts followers handle
bun scripts/browse-x.ts following handle

options

markdown by default. --json for structured output, --full for metadata, --compact for less. use --cursor with the returned cursor to continue. run bun scripts/browse-x.ts --help for thread, feed, and other options.

optional: X_MD_API_KEY sends a bearer key; X_API_BASE changes the host. never print the key. invalid or disabled keys return 401.

limits

public and keyed requests have different quotas. on 429 (exit 3), wait for the printed Retry-After; don't loop retries. exit 2 means bad arguments, exit 1 means another error. private or deleted content may be unavailable. check warnings; don't invent missing replies, media, or pinned posts.

Comments

Markdown supported