Fb-assistant-ts NPM

fb-assistant-ts

Description

fb-assistant-ts is a TypeScript library designed to automate interactions with Facebook using Puppeteer. It includes features such as logging in, handling captchas, and more. This library is perfect for developers looking to automate Facebook tasks for testing or scraping purposes.

Features

Facebook Login: Automate the login process to Facebook.
Captcha Handling: Automatically download and transcribe audio captchas using Google Generative AI.
TypeScript Support: Written in TypeScript for type safety and better development experience.

Installation

To install the library, use npm, yarn, pnpm, or Bun:

npm install fb-assistant-ts

yarn add fb-assistant-ts

pnpm add fb-assistant-ts

bun add fb-assistant-ts

Usage

Facebook Login and Accessing Messenger

Here's an example of how to use the FacebookLogin class to log in to Facebook and access the Messenger view:

import { FacebookLogin } from 'fb-assistant-ts';

const loginOptions = {
  apiKey: 'YOUR_GOOGLE_GENERATIVE_AI_API_KEY',
  email: 'your-email@example.com',
  password: 'your-password',
  debug: true,
  audioFilePath: 'captcha.mp3'
};

const fbLogin = new FacebookLogin(loginOptions);

(async () => {
  try {
    const page = await fbLogin.login();
    console.log('Logged in successfully!');

    // Navigate to Messenger
    await page.goto('https://www.facebook.com/messages/t/');
    console.log('Navigated to Messenger!');

    // Perform further actions with the Messenger page

    // Navigate to Facebook Marketplace Messenger
    await page.goto('https://www.facebook.com/marketplace/messages/');
    console.log('Navigated to Facebook Marketplace Messenger!');
    
    // Perform further actions with the Marketplace Messenger page
  } catch (error) {
    console.error('Login failed:', error);
  } finally {
    await fbLogin.close();
  }
})();

Marketplace Messenger

Here's an example of how to use the MarketplaceMessenger class to interact with Facebook Marketplace Messenger:

import { FacebookLogin, MarketplaceMessenger } from 'fb-assistant-ts';

const loginOptions = {
  apiKey: 'YOUR_GOOGLE_GENERATIVE_AI_API_KEY',
  email: 'your-email@example.com',
  password: 'your-password',
  debug: true,
  audioFilePath: 'captcha.mp3'
};

const fbLogin = new FacebookLogin(loginOptions);

(async () => {
  try {
    const page = await fbLogin.login();
    console.log('Logged in successfully!');

    const messenger = new MarketplaceMessenger(page);

    await messenger.navigateToMessages();
    await messenger.skipCodePopup();
    await messenger.doNotRestoreMessages();
    await messenger.openMarketplaceMessagesContainer();
    // await messenger.enterCode('245924');
    // await messenger.openMarketplace();

    // Example usage of the MarketplaceMessenger class
    // await messenger.sendMessage('Recipient Name', 'Hello, this is a test message!');
    // const lastMessage = await messenger.getLastMessage();
    // console.log('Last message:', lastMessage);

    // Close the browser after some time
    /* setTimeout(async () => {
      await fbLogin.close();
    }, 10000); // Close after 10 seconds */
  } catch (error) {
    console.error('Login failed:', error);
  } finally {
    await fbLogin.close();
  }
})();

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any bugs or feature requests. Your contributions help make this project better and more useful for everyone.