threads-lyr

What it does

• get_threads_profile — bio, follower/following/post counts for any public profile

• get_user_threads — recent public threads (text, url, created_at, engagement)

• close_session — release scrape clients

• Agent-first CLI — AXI-compliant (--list-tools, --tool-info, --json, --hook, --install-hook, --install-skill)

• Two MCP transports — stdio and streamable-http

Threads posts and profiles are public, so the client fetches threads.net/@username directly — Chrome TLS impersonation gets through, no credentials required. Cloned from facebook-lyr and stripped to Threads only.

Related MCP server: threads-mcp

Why anonymous scraping?

The official Threads API requires Meta app registration and access tokens, and writing tools need authorized credentials. For reading public content, that's heavy machinery for a problem an anonymous fetch already solves.

• curl_cffi with Chrome TLS impersonation defeats JA3 fingerprint detection.

• Profiles and feeds are parsed from Threads' embedded JSON with a resilient deep-scan — no fragile selectors.

• Tools are annotated readOnlyHint so agents know not to attempt writes.

Quick install

./install.sh      # or: uv sync
uv run threads-lyr --status          # anonymous — always valid

Direct CLI tool execution

uv run threads-lyr get_threads_profile --username zuck
uv run threads-lyr get_user_threads --username zuck --limit 10
uv run threads-lyr get_user_threads --username zuck --limit 5 --json
uv run threads-lyr --list-tools

MCP server

Spawn with no args on a pipe (as Claude Code / other MCP clients do):

threads-lyr          # starts the JSON-RPC stdio server

For the streamable-http transport:

TRANSPORT=streamable-http PORT=8000 threads-lyr

Honest platform limits

• Read-only. Publishing on Threads requires the official Threads API — out of scope for anonymous scraping.

• Anonymous. Only public profiles are reachable; private profiles return not-found/empty.

Layout

threads_mcp_server/
  scraping/     curl_cffi Chrome-impersonation client + embedded-JSON parsers
  tools/        FastMCP tool registration (threads_tools.py)
  server.py     FastMCP server assembly
  cli_main.py   AXI-compliant CLI
  config/       layered config (CLI args > env > defaults)

Visual proof

Related CLI Tools

This project is part of a family of agent-friendly CLI tools for social platforms:

License

MIT — see LICENSE.

☕ Support & Sponsorship

If you find this project useful, consider supporting ongoing development:

Your support funds new features, releases, and infrastructure for the whole ecosystem.