---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/social-reader
---
# Social Reader

Read any social media URL, profile, or feed. Auto-detects platform from URLs across TikTok, Instagram, YouTube, Twitter/X, Facebook, LinkedIn, Reddit, Threads, Bluesky, Pinterest, Twitch, Kick, Snapchat, and Truth Social. Also reads RSS feeds and web pages.

- **Version:** 0.01
- **Categories:** data, search

## Skills (8)

### Read URL (`read_url`)

Paste any social media URL — auto-detects the platform and content type and returns structured data. Falls back to clean markdown for unrecognized URLs.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL to read |

**Returns:** Structured content from the detected platform, or clean markdown for web pages. Includes detected_platform and detected_type metadata.

**Examples:**

*Read a tweet:*

```json
{
  "url": "https://x.com/elonmusk/status/1234567890123456789"
}
```

*Read a TikTok video:*

```json
{
  "url": "https://www.tiktok.com/@charlidamelio/video/7234567890123456789"
}
```

*Read a Reddit post:*

```json
{
  "url": "https://www.reddit.com/r/technology/comments/abc123/some_post"
}
```

*Read any web page:*

```json
{
  "url": "https://example.com/article"
}
```

### Read Profile (`read_profile`)

Get profile data for any social media account by username and platform. Returns bio, follower counts, engagement metrics, and profile details.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username or handle (without @ prefix) |
| `platform` | string | Yes | Platform: tiktok, instagram, youtube, twitter, linkedin, facebook, reddit, threads, bluesky, truthsocial, snapchat, twitch (tiktok, instagram, youtube, twitter, linkedin, facebook, reddit, threads, bluesky, truthsocial, snapchat, twitch) |

**Returns:** Profile data including bio, follower/following counts, engagement metrics, and profile media

**Examples:**

*Get a TikTok profile:*

```json
{
  "handle": "charlidamelio",
  "platform": "tiktok"
}
```

*Get a Twitter profile:*

```json
{
  "handle": "elonmusk",
  "platform": "twitter"
}
```

*Get subreddit info:*

```json
{
  "handle": "technology",
  "platform": "reddit"
}
```

### Read Posts (`read_posts`)

Get recent posts from any social media account. Supports content type filtering: Instagram (posts, reels, highlights), YouTube (videos, shorts), Facebook (posts, reels, photos).

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `handle` | string | Yes | Username, handle, or identifier |
| `platform` | string | Yes | Platform (tiktok, instagram, youtube, twitter, facebook, linkedin, threads, bluesky, truthsocial, reddit, pinterest) |
| `content_type` | string | No | Content type filter. Instagram: posts, reels, highlights. YouTube: videos, shorts. Facebook: posts, reels, photos. |

**Returns:** Array of posts with captions, engagement metrics, media URLs, and timestamps

**Examples:**

*Get Instagram posts:*

```json
{
  "handle": "natgeo",
  "platform": "instagram"
}
```

*Get Instagram reels:*

```json
{
  "handle": "natgeo",
  "platform": "instagram",
  "content_type": "reels"
}
```

*Get YouTube shorts:*

```json
{
  "handle": "mkbhd",
  "platform": "youtube",
  "content_type": "shorts"
}
```

### Read Comments (`read_comments`)

Get the comment thread for any post URL. Supports TikTok, YouTube, Instagram, Facebook, Reddit, Twitter, and Threads.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL to read |

**Returns:** Comments with author info, text, likes/upvotes, timestamps, and nested replies

**Examples:**

*Get comments on a YouTube video:*

```json
{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
```

*Get Reddit post comments:*

```json
{
  "url": "https://www.reddit.com/r/technology/comments/abc123/some_post"
}
```

### Search Posts (`search_posts`)

Search for content across social platforms. Specify a platform for focused search, or omit to search TikTok, YouTube, Twitter, and Reddit simultaneously.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query |
| `platform` | string | No | Limit to one platform. Omit for multi-platform search. (tiktok, youtube, twitter, reddit, pinterest, instagram) |
| `search_type` | string | No | Type of search: posts (default), users, hashtags. (posts, users, hashtags) |

**Returns:** Search results with content, authors, and engagement metrics. Multi-platform search returns results grouped by platform.

**Examples:**

*Search TikTok for cooking videos:*

```json
{
  "query": "cooking tips",
  "platform": "tiktok"
}
```

*Search everywhere for AI news:*

```json
{
  "query": "artificial intelligence"
}
```

*Find TikTok users:*

```json
{
  "query": "fitness",
  "platform": "tiktok",
  "search_type": "users"
}
```

### Get Trending (`get_trending`)

Get trending content. TikTok: videos, songs, hashtags, creators, or For You feed. YouTube: trending Shorts.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `platform` | string | Yes | Platform: tiktok or youtube (tiktok, youtube) |
| `trending_type` | string | No | TikTok: videos, songs, hashtags, creators, feed. YouTube: shorts. |
| `country` | string | No | ISO country code (e.g. US, GB) |
| `period` | string | No | Time period in days: 1, 7, or 30 |

**Returns:** Trending content with engagement metrics, sorted by popularity

**Examples:**

*Get trending TikTok videos:*

```json
{
  "platform": "tiktok"
}
```

*Get trending TikTok songs in the US:*

```json
{
  "platform": "tiktok",
  "trending_type": "songs",
  "country": "US"
}
```

### Read Feed (`read_feed`)

Parse any RSS or Atom feed URL. Returns structured feed items with titles, links, descriptions, dates, and authors.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | RSS or Atom feed URL |

**Returns:** Feed metadata and array of items with title, link, description, published date, and author

**Examples:**

*Read a blog RSS feed:*

```json
{
  "url": "https://blog.example.com/feed.xml"
}
```

*Read Hacker News RSS:*

```json
{
  "url": "https://hnrss.org/frontpage"
}
```

### Read Webpage (`read_webpage`)

Read any web page as clean markdown text. Strips navigation, ads, and boilerplate to extract the main content.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the web page to read |

**Returns:** Clean markdown text of the main page content

**Examples:**

*Read a news article:*

```json
{
  "url": "https://www.bbc.com/news/technology-12345678"
}
```

*Read a blog post:*

```json
{
  "url": "https://blog.example.com/my-post"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call social-reader read_url --url https://x.com/elonmusk/status/1234567890123456789

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"social-reader","skill":"read_url","input":{"url":"https://x.com/elonmusk/status/1234567890123456789"}}' \
     https://api.toolrouter.com/v1/tools/call
```

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs