TangilHossain/TLDR

โ˜… 0Forks 0JavaScriptGitHub โ†—Compare

README

Facebook Post Scraper Chrome Extension

A Chrome extension that Summarize facebook Posts.

Features

  • ๐Ÿ” Smart Post Detection: Automatically identifies Facebook posts using multiple selector strategies
  • ๐Ÿ“Š Summary Generation: Can generate summary of the post
  • ๐Ÿ‘ค Multi Lingual Support: Can support both Bengali & English

Installation

  1. Download or clone this repository
  2. Open Chrome and go to chrome://extensions/
  3. Enable "Developer mode" in the top right
  4. Click "Load unpacked" and select the extension folder
  5. The extension icon will appear in your Chrome toolbar

Usage

  1. Navigate to Facebook.com
  2. Click on the extension icon in your Chrome toolbar
  3. Paste your api key in the popup window
  4. Reload the facebook tab
  5. Press the summarize button to "summarize" any post and wait 5 to 10 seconds
  6. If generation is failed, press "summaraize" button again and wait 5 to 10 seconds

Privacy and Ethics

โš ๏ธ Important Notes:

  • This extension is for educational and research purposes only
  • Always respect Facebook's Terms of Service and robots.txt
  • Do not use this tool to violate privacy or scrape personal data without consent
  • Be mindful of rate limiting and avoid excessive use of api key
  • Consider the ethical implications of data collection

Technical Details

  • Manifest Version: 3 (latest Chrome extension standard)
  • Permissions:
    • activeTab: Access to current tab
    • scripting: Inject content scripts
    • storage: Local data storage
  • Host Permissions: Facebook domains only
  • Architecture:
    • Background script for persistence
    • Content script for DOM manipulation
    • Popup interface for user interaction

Limitations

  • Facebook frequently updates their DOM structure, which may break selectors
  • Some posts may not be accessible due to privacy settings
  • Rate limiting by Openrouter may prevent scraping large amounts of data
  • The extension works best with public posts and pages

Contributing

Feel free to submit issues, feature requests, or pull requests to improve this extension.

License

This project is for educational purposes. Please use responsibly and in accordance with Facebook's Terms of Service.


Disclaimer: This tool is provided as-is for educational purposes. Users are responsible for complying with Facebook's Terms of Service and applicable laws regarding data scraping and privacy.

Contributors

TangilHossainas-kashmary

Issues