mashrur-facebook-scraper 2.0.0

Professional-grade Facebook data extraction tool with Nuitka compilation support

Mashrur Facebook Scraper - Ultra Simple

Made by Mashrur Rahman

Ultra Simple - Just 5 Parameters

from mashrur_facebook_scraper import scrape_facebook_posts

posts = scrape_facebook_posts("email", "password", "page_url", num_posts, "output_file.json")

Installation

pip install mashrur-facebook-scraper

Usage

Create your scraper file:

from mashrur_facebook_scraper import scrape_facebook_posts

posts = scrape_facebook_posts(
    "[e-mail]",
    "your_password",
    "https://www.facebook.com/indianexpress",
    5,
    "my_data.json"
)

print(f"Scraped {len(posts)} posts!")

Function Parameters

Parameter	Type	Description
email	str	Your Facebook email
password	str	Your Facebook password
page_url	str	Facebook page URL
num_posts	int	Number of posts
output_filename	str	Output JSON filename

Output Format

The scraper generates clean JSON data with the following structure:

[
  {
    "post_id": "123456789",
    "url": "https://facebook.com/posts/123456789",
    "content": "Post content text here...",
    "user_username_raw": "Page Name",
    "date_posted": "2025-01-15T10:30:00Z",
    "likes": 1250,
    "num_comments": 45,
    "num_shares": 12,
    "media_urls": ["https://facebook.com/image1.jpg"],
    "hashtags": ["#example", "#hashtag"],
    "post_type": "Post",
    "is_sponsored": false
  }
]

Advanced Examples

Batch Processing Multiple Pages

from mashrur_facebook_scraper import scrape_facebook_posts

pages = [
    "https://www.facebook.com/cnn",
    "https://www.facebook.com/bbc",
    "https://www.facebook.com/reuters"
]

for page in pages:
    page_name = page.split('/')[-1]
    filename = f"{page_name}_posts.json"

    posts = scrape_facebook_posts(
        email="[e-mail]",
        password="your_password",
        page_url=page,
        num_posts=20,
        output_filename=filename
    )

    print(f"Scraped {len(posts)} posts from {page_name}")

Error Handling

from mashrur_facebook_scraper import scrape_facebook_posts

try:
    posts = scrape_facebook_posts(
        email="[e-mail]",
        password="your_password",
        page_url="https://www.facebook.com/invalidpage",
        num_posts=10
    )
except ValueError as e:
    print(f"Input error: {e}")
except Exception as e:
    print(f"Scraping error: {e}")

Requirements

• Python 3.7 or higher
• Chrome browser installed
• Valid Facebook credentials
• Stable internet connection

Support

• Email: [e-mail]
• Documentation: https://docs.mashrur-scraper.com

License

Proprietary - All rights reserved to Mashrur Rahman