FacebookContext

A Facebook request context.

Manages the shared session, cookies, and GraphQL request state.

Constructor

Creates a Facebook request context.

FacebookContext(cookies_file, state_file, user_agent, proxy, quiet, debug, debug_dir)

Parameters

cookies_file : str

Path to the Facebook cookies JSON file. Defaults to "facebook_cookies.json".

state_file : str

Path where request state is persisted between runs. Defaults to "facebook_state.json".

user_agent : str | None

User-Agent for Facebook requests. When not provided, a fallback default is used.

proxy : str | None

Proxy URL for HTTP/HTTPS requests, e.g. http://user:password@host:port.

quiet : bool

When True, suppresses progress output. Defaults to False.

debug : bool

When True, saves every GraphQL request and response to disk. Defaults to False.

debug_dir : str

Directory where debug files are written. Defaults to "graphql_debug".

Methods

reload_cookies() : None

Re-read cookies_file into the current session.

Usage

import facebook_gql_scraper as fgs

context = fgs.FacebookContext(cookies_file="facebook_cookies.json")

# Pass the context to any model constructor
user = fgs.Profile.from_user_id(context, user_id="100084254631043")