README.md

CDP Agentkit Extension - Twitter langchain Toolkit

This toolkit contains tools that enable an LLM agent to interact with Twitter (X). The toolkit provides a wrapper around the Twitter (X) API, allowing agents to perform social operations like posting text.

Prerequisites

• Node.js 18 or higher
• OpenAI API Key
• Twitter (X) App Developer Keys

Installation

npm install @coinbase/twitter-langchain

Environment Setup

Set the following environment variables:

export OPENAI_API_KEY=<your-openai-api-key>
export TWITTER_API_KEY=<your-api-key>
export TWITTER_API_SECRET=<your-api-secret>
export TWITTER_ACCESS_TOKEN=<your-access-token>
export TWITTER_ACCESS_TOKEN_SECRET=<your-access-token-secret>

Usage

Basic Setup

import { TwitterAgentkit } from "@coinbase/cdp-agentkit-core";
import { TwitterToolkit } from "@coinbase/twitter-langchain";

// Initialize Twitter AgentKit
const agentkit = new TwitterAgentkit();

// Create toolkit
const toolkit = new TwitterToolkit(agentkit);

// Get available tools
const tools = toolkit.getTools();

Available Tools

The toolkit provides the following tools:

1. account_details - Get the authenticated account details
2. account_mentions - Get mentions for a specified account
3. post_tweet - Post a tweet to the account
4. post_tweet_reply - Post a reply to a tweet on Twitter

Using with an Agent

Additional Installations

npm install @langchain/langgraph @langchain/openai

import { ChatOpenAI } from "@langchain/openai";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

// Initialize LLM
const model = new ChatOpenAI({
  model: "gpt-4o-mini",
});

// Create agent executor
const agent = createReactAgent({
  llm: model,
  tools,
});

// Example usage
const result = await agent.invoke({
  messages: [new HumanMessage("please post 'hello, world!' to twitter")],
});

console.log(result.messages[result.messages.length - 1].content);

Examples

Check out examples/ for inspiration and help getting started:

• Chatbot: Interactive chatbot with Twitter (X) capabilities

Contributing

See CONTRIBUTING.md for detailed setup instructions and contribution guidelines.

Documentation

• CDP AgentKit Documentation
• API Reference: CDP AgentKit Twitter Langchain Extension

License

Apache-2.0