{
  "markdown": "# CarryFeed Agent Tools\n\n[![skills.sh](https://skills.sh/b/christian-beep383/carryfeed-agent-tools)](https://skills.sh/christian-beep383/carryfeed-agent-tools)\n[![npm @carryfeed/sdk](https://img.shields.io/npm/v/@carryfeed/sdk?label=%40carryfeed%2Fsdk)](https://www.npmjs.com/package/@carryfeed/sdk)\n[![npm @carryfeed/cli](https://img.shields.io/npm/v/@carryfeed/cli?label=%40carryfeed%2Fcli)](https://www.npmjs.com/package/@carryfeed/cli)\n[![npm @carryfeed/mcp](https://img.shields.io/npm/v/@carryfeed/mcp?label=%40carryfeed%2Fmcp)](https://www.npmjs.com/package/@carryfeed/mcp)\n\nPublic SDK, CLI, MCP server, OpenAPI notes, and agent skill wrappers for the hosted [CarryFeed](https://carryfeed.com) API.\n\nThis 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.\n\nCarryFeed 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.\n\nUseful links:\n\n- Website: [carryfeed.com](https://carryfeed.com)\n- API health: [api.carryfeed.com/health](https://api.carryfeed.com/health)\n- Agent discovery: [carryfeed.com/llms.txt](https://carryfeed.com/llms.txt)\n- OpenAPI: [carryfeed.com/openapi.json](https://carryfeed.com/openapi.json)\n- Video downloader: [carryfeed.com/twitter-video-downloader](https://carryfeed.com/twitter-video-downloader)\n- Image downloader: [carryfeed.com/twitter-image-downloader](https://carryfeed.com/twitter-image-downloader)\n- GIF downloader: [carryfeed.com/twitter-gif-downloader](https://carryfeed.com/twitter-gif-downloader)\n- Viewer guide: [carryfeed.com/how-to-view-twitter-without-account](https://carryfeed.com/how-to-view-twitter-without-account)\n\n## Packages\n\n- `@carryfeed/sdk`: JavaScript SDK for the hosted CarryFeed API.\n- `@carryfeed/cli`: CLI wrapper for agents and local scripts.\n- `@carryfeed/mcp`: stdio MCP server for MCP-capable agents.\n- `skills/carryfeed-twitter-tools`: Agent skill instructions for public X/Twitter link workflows.\n\n## Public Scope\n\nCarryFeed 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.\n\n## Why Agents Use CarryFeed\n\n- One hosted API instead of brittle browser automation.\n- Public profile, post, article, image, video, and GIF-style media workflows in one place.\n- Source URL, author context, text, and media candidates stay together.\n- Clear public-only boundaries that help agents avoid overclaiming access.\n- CORS-friendly API, OpenAPI notes, CLI examples, and an agent skill.\n- Download helper for public `pbs.twimg.com` and `video.twimg.com` media URLs.\n\n## Quick Start\n\n```bash\nnpm install @carryfeed/sdk\n```\n\n```js\nimport { CarryFeedClient } from \"@carryfeed/sdk\";\n\nconst carryfeed = new CarryFeedClient();\nconst post = await carryfeed.resolve(\"https://x.com/user/status/123\");\nconst media = await carryfeed.resolveMedia(\"https://x.com/user/status/123\");\nconst profile = await carryfeed.getProfile(\"NASA\");\n```\n\nCLI:\n\n```bash\nnpx -y @carryfeed/cli resolve https://x.com/user/status/123 --compact\nnpx -y @carryfeed/cli media https://x.com/user/status/123 --compact\nnpx -y @carryfeed/cli profile NASA --statuses --count 5 --compact\n```\n\nMCP:\n\n```json\n{\n  \"mcpServers\": {\n    \"carryfeed\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carryfeed/mcp\"]\n    }\n  }\n}\n```\n\n## Agent Docs\n\nSee [docs/agents.md](docs/agents.md) for agent-facing usage, response expectations, and safety boundaries.\n\n## Agent Skill\n\nThe 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. SDK and OpenAPI details are kept for developers, while the skill gives agents one default path.\n\nAfter this repository is public, agents that support the Skills CLI can install it with:\n\n```bash\nnpx skills add christian-beep383/carryfeed-agent-tools --skill carryfeed-twitter-tools\n```\n\nFor ClawHub, publish from the skill folder after the npm packages and public repository are ready:\n\n```bash\nclawhub skill publish . --slug carryfeed-twitter-tools --name \"CarryFeed Twitter Tools\" --version 0.1.0 --changelog \"Initial release\"\n```\n\n## Roadmap\n\nTwitter/X search and hashtag search are planned as a later API surface. See [docs/roadmap.md](docs/roadmap.md).\n\n## Publishing\n\nThe npm scope is `@carryfeed`.\n\nDry-run package contents:\n\n```bash\nnpm run pack:sdk\nnpm run pack:cli\nnpm run pack:mcp\n```\n\nPublish when logged in as an npm user with write access to the `carryfeed` organization:\n\n```bash\nnpm run publish:sdk\nnpm run publish:cli\nnpm run publish:mcp\n```\n\nRecommended first GitHub remote:\n\n```bash\ngit remote add origin https://github.com/christian-beep383/carryfeed-agent-tools.git\n```\n",
  "bytes": 5089,
  "sha": "e212e5cbabd4e6ece7acdf81a58e402d68f1dc1b89675737e367c895ff959709",
  "repo_slug": "christian-beep383/carryfeed-agent-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_christian_beep383_carryfeed_2faea5ac/readme"
}