CarryFeed Agent Tools

Public SDK, CLI, MCP server, OpenAPI notes, and agent skill wrappers for the hosted CarryFeed API.

This repository is intentionally a wrapper layer. It does not include CarryFeed's internal resolver implementation, Worker source, direct X/Twitter client code, tokens, cookies, or scraping internals.

CarryFeed gives agents one stable, source-preserving way to read public X/Twitter links. Instead of driving a browser, handling login prompts, or losing source context in screenshots, agents can call a hosted API and receive public profile, post, article, and media metadata with the original URL kept beside the result.

Useful links:

• Website: carryfeed.com
• API health: api.carryfeed.com/health
• Agent discovery: carryfeed.com/llms.txt
• OpenAPI: carryfeed.com/openapi.json
• Video downloader: carryfeed.com/twitter-video-downloader
• Image downloader: carryfeed.com/twitter-image-downloader
• GIF downloader: carryfeed.com/twitter-gif-downloader
• Viewer guide: carryfeed.com/how-to-view-twitter-without-account

Packages

• @carryfeed/sdk: JavaScript SDK for the hosted CarryFeed API.
• @carryfeed/cli: CLI wrapper for agents and local scripts.
• @carryfeed/mcp: stdio MCP server for MCP-capable agents.
• skills/carryfeed-twitter-tools: Agent skill instructions for public X/Twitter link workflows.

Public Scope

CarryFeed works with public X and Twitter links only. It is designed for public profile, post, article, and media metadata workflows. It does not unlock private, protected, deleted, restricted, or login-only content.

Why Agents Use CarryFeed

• One hosted API instead of brittle browser automation.
• Public profile, post, article, image, video, and GIF-style media workflows in one place.
• Source URL, author context, text, and media candidates stay together.
• Clear public-only boundaries that help agents avoid overclaiming access.
• CORS-friendly API, OpenAPI notes, CLI examples, and an agent skill.
• Download helper for public pbs.twimg.com and video.twimg.com media URLs.

Quick Start

npm install @carryfeed/sdk

import { CarryFeedClient } from "@carryfeed/sdk";

const carryfeed = new CarryFeedClient();
const post = await carryfeed.resolve("https://x.com/user/status/123");
const media = await carryfeed.resolveMedia("https://x.com/user/status/123");
const profile = await carryfeed.getProfile("NASA");

CLI:

npx -y @carryfeed/cli resolve https://x.com/user/status/123 --compact
npx -y @carryfeed/cli media https://x.com/user/status/123 --compact
npx -y @carryfeed/cli profile NASA --statuses --count 5 --compact

MCP:

{
  "mcpServers": {
    "carryfeed": {
      "command": "npx",
      "args": ["-y", "@carryfeed/mcp"]
    }
  }
}

Agent Docs

See docs/agents.md for agent-facing usage, response expectations, and safety boundaries.

Agent Skill

The repository includes skills/carryfeed-twitter-tools, a wrapper-only skill that tells agents to use npx -y @carryfeed/cli for public X/Twitter source context. SD

... View full README on GitHub