Twitter Search

export const twitterSearch = ai.defineTool(
  {
    name: 'twitterSearch',
    description: 'Searches X (formerly Twitter) for recent, relevant public tweets using a keyword query. Returns a list of tweets with author and metric details.',
    inputSchema: TwitterSearchInputSchema,
    outputSchema: TwitterSearchOutputSchema,
  },
  async (input) => { ... }
)

const TwitterSearchInputSchema = z.object({
  query: z.string().describe('The search query for X/Twitter. Exclude hashtags or "from:" filters, just provide the keywords.'),
});

const TweetAuthorSchema = z.object({
  name: z.string(),
  username: z.string(),
  profile_image_url: z.string().url(),
});

const PublicMetricsSchema = z.object({
  retweet_count: z.number(),
  reply_count: z.number(),
  like_count: z.number(),
  impression_count: z.number(),
});

const TweetResultSchema = z.object({
  id: z.string(),
  text: z.string(),
  author: TweetAuthorSchema,
  created_at: z.string(),
  public_metrics: PublicMetricsSchema,
});

const TwitterSearchOutputSchema = z.array(TweetResultSchema);

import { twitterSearch } from '@/ai/tools/twitter-search';

const tweets = await twitterSearch({ 
  query: 'climate change' 
});

console.log(`Found ${tweets.length} tweets`);

tweets.forEach(tweet => {
  console.log(`@${tweet.author.username}: ${tweet.text}`);
  console.log(`Likes: ${tweet.public_metrics.like_count}`);
});

import { ai } from '@/ai/genkit';
import { twitterSearch } from '@/ai/tools/twitter-search';

const response = await ai.generate({
  prompt: 'What are people saying about climate change on Twitter?',
  tools: [twitterSearch],
});

const twitterResult = await twitterSearch({ query: searchQuery });

if (twitterResult && twitterResult.length > 0) {
  const sortedTweets = twitterResult.sort(
    (a, b) => b.public_metrics.like_count - a.public_metrics.like_count
  );
  tweets = sortedTweets;
}

{your_query} lang:en -is:retweet

TWITTER_BEARER_TOKEN=your_bearer_token_here