Twitter Scraper Mcp
What is Twitter Scraper Mcp
twitter-scraper-mcp is an MCP (Model Context Protocol) server that provides tools for interacting with Twitter using the agent-twitter-client library.
Use cases
Use cases include retrieving specific tweets for analysis, automating tweet posting for marketing campaigns, and integrating Twitter functionalities into applications.
How to use
To use twitter-scraper-mcp, clone the repository, install the dependencies using npm or yarn, and set up a .env file with your Twitter credentials. You can run the server using FastMCP CLI tools for development and testing.
Key features
Key features include retrieving tweets by their ID with the getTweet function and posting new tweets to Twitter with the sendTweet function.
Where to use
twitter-scraper-mcp can be used in social media management, data analysis, and automation tasks involving Twitter interactions.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Twitter Scraper Mcp
twitter-scraper-mcp is an MCP (Model Context Protocol) server that provides tools for interacting with Twitter using the agent-twitter-client library.
Use cases
Use cases include retrieving specific tweets for analysis, automating tweet posting for marketing campaigns, and integrating Twitter functionalities into applications.
How to use
To use twitter-scraper-mcp, clone the repository, install the dependencies using npm or yarn, and set up a .env file with your Twitter credentials. You can run the server using FastMCP CLI tools for development and testing.
Key features
Key features include retrieving tweets by their ID with the getTweet function and posting new tweets to Twitter with the sendTweet function.
Where to use
twitter-scraper-mcp can be used in social media management, data analysis, and automation tasks involving Twitter interactions.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Twitter MCP Server
An MCP (Model Context Protocol) server that provides tools for interacting with Twitter using the agent-twitter-client library.
Features
- getTweet: Retrieve a tweet by its ID
- sendTweet: Post a new tweet to Twitter
Prerequisites
- Node.js (v14 or higher)
- npm or yarn
- Twitter account credentials
Installation
- Clone this repository
- Install dependencies:
npm install
# or
yarn install
- Create a
.envfile in the root directory with your Twitter credentials:
TWITTER_USERNAME=your_twitter_username TWITTER_PASSWORD=your_twitter_password [email protected] (optional) TWITTER_2FA_SECRET=your_2fa_secret (optional) # Optional API credentials (used as fallback) TWITTER_API_KEY=your_api_key TWITTER_API_SECRET_KEY=your_api_secret_key TWITTER_ACCESS_TOKEN=your_access_token TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret
Usage
Running the Server
You can run the server using the FastMCP CLI tools:
# For development and testing in the terminal
npx fastmcp dev
# For visual inspection with the MCP Inspector
npx fastmcp inspect
Using the Tools
getTweet
Retrieves a tweet by its ID.
Parameters:
tweetId(string): The ID of the tweet to retrieve
Example:
getTweet({"tweetId": "1734609533274853865"})
sendTweet
Posts a new tweet to Twitter.
Parameters:
text(string): The text content of the tweet to send
Example:
sendTweet({"text": "Hello World from MCP!"})
Development
This server is built using:
- FastMCP - A TypeScript framework for building MCP servers
- agent-twitter-client - A Twitter client library
To build the TypeScript code:
npx tsc
License
MIT
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
