twitterSearch

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().describe("The author's display name."),
  username: z.string().describe("The author's unique username/handle."),
  profile_image_url: z.string().url().describe("URL to the author's profile picture."),
});

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().describe('The unique ID of the tweet.'),
  text: z.string().describe('The full text content of the tweet.'),
  author: TweetAuthorSchema,
  created_at: z.string().describe('The date and time the tweet was created.'),
  public_metrics: PublicMetricsSchema.describe('Engagement metrics for the tweet.'),
});

const TwitterSearchOutputSchema = z.array(TweetResultSchema);

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

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

console.log(tweets);
// [
//   {
//     id: '1234567890',
//     text: 'Important discussion about climate change impacts...',
//     created_at: '2024-01-15T10:30:00.000Z',
//     author: {
//       name: 'Jane Doe',
//       username: 'janedoe',
//       profile_image_url: 'https://pbs.twimg.com/profile_images/...'
//     },
//     public_metrics: {
//       retweet_count: 45,
//       reply_count: 12,
//       like_count: 230,
//       impression_count: 5600
//     }
//   },
//   // ... up to 20 tweets
// ]