At the start of the academic year whilst working with a at university I ran into a problem — how do you invite people to a group in bulk? It turns out that with a little bit of Python it’s easy. For the source code see the , keep reading for a walkthrough. student society Facebook Github repository _facebook-bulk-group-inviter - Python CLI to import members to Facebook groups via email in bulk_github.com danielireson/facebook-bulk-group-inviter Why Python? Python is a great choice of language for this kind of task because it’s lightweight and easy to write. I personally love how well it reads. Consider the following piece of code where you can understand the logic even if you don’t know Python syntax. It reads like English. secret '' secret 'medium':secret input('What's the secret?') secret 'medium':print('Correct') :print('Incorrect') = while != = if == else But Python is really just one suitable option — the script could quite have easily have been written in many other languages. Selenium (which we will use to automate the browser) also has client APIs available for C#, Java, JavaScript and Ruby. There’s other non-Selenium solutions that could have been used as well. The task View a Facebook group that you’re a member of and look on the right hand-side, you’ll see an add members section. Here you can enter an email address and it will invite the person to join the group. Manchester Startups Facebook group It does this whether the user has a Facebook account or not. Try inviting yourself to the group and see what happens. You should shortly receive an email in your inbox. Broken down the process involves five steps. Log in to Facebook. Navigate to the Facebook group page. Enter the email address of a user to invite. Submit the input. Repeat steps 3 and 4 for a list of email addresses. Create the CLI The script has to be able to login as a user who has access to the Facebook group, it therefore needs access to personal login details. For this reason it’s a good idea to design it as a CLI. One of the benefits of Python is its huge standard library. There’s a module called that we can use to parse CLI arguments and one called which can be used to prompt the user for a password. Create a new file with the following code (and install beforehand if you don’t already have it installed). argparse getpass main.py Python # main.py import argparseimport getpass def main():parser = argparse.ArgumentParser(description='This tool lets you invite people in bulk to your Facebook group')parser.add_argument('-e','--email', help='Your personal Facebook account email', required=True)parser.add_argument('-g','--group', help='The Facebook group name', required=True)args = vars(parser.parse_args())args['password'] = getpass.getpass() if __name__ == '__main__':main() Open up your terminal, navigate to the directory where you saved the file and enter . You should receive an error asking you to pass the two required arguments — email and group name. These are passed via flags. You should then be prompted to enter a password. python main.py python main.py -e johndoe@example.com -g groupname Load emails from a CSV CSV is a widely supported file format that stores a list of comma separated values. I had my email addresses stored in a CSV in the following structure. john@example.com,jane@example.com Using Python we can easily write some code to parse this file. Let’s create an class. EmailLoader # email_loader.py import csvimport osimport sys class EmailLoader:filename = 'emails.csv'emails = [] def __init__(self):dir_path = os.path.dirname(os.path.realpath(__file__))file_path = dir_path + '/' + self.filenameif not os.path.isfile(file_path):sys.exit('File does not exist: ' + self.filename) with open(file\_path, 'rb') as file: csv\_reader = csv.reader(file) for email in csv\_reader: self.emails.append(email\[0\]) if len(self.emails) < 1: sys.exit('There are no emails in your supplied file') else: print('Loaded ' + str(len(self.emails))) It presumes the CSV has a filename of and is located in the same directory. It loads email addresses into the array property. emails.csv emails from email_loader import EmailLoader email_loader = EmailLoader()print(email_loader.emails) Setup Selenium To control the web browser we’re going to use , a powerful open-source browser automation primarily used for testing. You can install it using Python’s package manager pip by entering in the terminal. Selenium requires a vendor driver to work. We’ll be using the driver which allows us to control a PhantomJS headless browser. A headless browser is a browser without a visible user interface. Download the correct PhantomJS driver for your operating system from their and copy it your working directory (you will need to extract the driver from the folder of the zip download). Continuing with an object-oriented pattern, let’s create a class to encapsulate working with Selenium. Selenium tool pip install selenium PhantomJS download page bin Browser # browser.py import os from selenium import webdriver class Browser:def __init__(self):dir_path = os.path.dirname(os.path.realpath(__file__))driver_path = dir_path + '/phantomjs-driver'self.browser = webdriver.PhantomJS(executable_path=driver_path) This class sets up Selenium using the PhantomJS driver on its instantiation. It assumes the driver is in the working directory with a filename of . phantomjs-driver Navigation Let’s add a navigate method to the class. Browser # browser.py import os from selenium import webdriverfrom selenium.common.exceptions import TimeoutExceptionfrom selenium.webdriver.common.by import Byfrom selenium.webdriver.support import expected_conditionsfrom selenium.webdriver.support.ui import WebDriverWait class Browser:def __init__(self):dir_path = os.path.dirname(os.path.realpath(__file__))driver_path = dir_path + '/phantomjs-driver'self.browser = webdriver.PhantomJS(executable_path=driver_path) def navigate(self, url, wait_for, error):try:print('Navigating to: ' + url)self.browser.get(url)element_present = expected_conditions.presence_of_element_located((By.ID, wait_for))WebDriverWait(self.browser, self.delay).until(element_present)except TimeoutException:sys.exit(error) The page to navigate to should be supplied as the first parameter. The second parameter is a div ID that can be found on the navigating page, this is used to ensure it has successfully loaded. The last parameter is an error message that is shown if the navigation is unsuccessful. This will only be shown if the try/catch block fails, in which case it will exit the CLI and print the error message. Using this method it becomes simple to navigate to the Facebook homepage. from browser import Browser browser = Browser()browser.navigate(url=' ,wait_for='facebook',error='Unable to load the Facebook website') https://www.facebook.com' Logging in to Facebook Our script needs to be able to automate the login. This is done on the Facebook homepage by input fields in the top right hand corner of the page. Simply enough, the email field has an ID of and the password field has an ID of We can use these IDs to lookup the inputs. Let’s create a method on our class to automate the login. email pass. Browser def enter_login_details(self, email, password):try:print('Entering login details')email_field = self.browser.find_element_by_id('email')pass_field = self.browser.find_element_by_id('pass')email_field.send_keys(email)pass_field.send_keys(password)pass_field.submit()element_present = expected_conditions.presence_of_element_located((By.ID, 'userNavigationLabel'))WebDriverWait(self.browser, self.delay).until(element_present)except TimeoutException:sys.exit('Login with your credentials unsuccessful') The method finds each field by an ID lookup and enters the appropriate value passed as a parameter. browser.enter_login_details(args['email'], args['password']) Navigating to the group page After logging in we need to navigate to the Facebook group page. This can be done using our navigate method from earlier. browser.navigate(url=' + args['group'],wait_for='pagelet_group_',error='Couldn\'t navigate to the group\'s members page') https://www.facebook.com/groups/' Automating the imports Now on the group page we need to loop through the imported email addresses and enter them one at a time into the input box in the sidebar. To do this we’ll add a new method on . add members import_members Browser # browser.py import osimport randomimport sysimport timeimport unicodedata from selenium import webdriverfrom selenium.common.exceptions import TimeoutExceptionfrom selenium.webdriver.common.by import Byfrom selenium.webdriver.common.keys import Keysfrom selenium.webdriver.support import expected_conditionsfrom selenium.webdriver.support.ui import WebDriverWait class Browser:delay = 3 def __init__(self):dir_path = os.path.dirname(os.path.realpath(__file__))driver_path = dir_path + '/phantomjs-driver'self.browser = webdriver.PhantomJS(executable_path=driver_path) def navigate(self, url, wait_for, error):try:print('Navigating to: ' + url)self.browser.get(url)element_present = expected_conditions.presence_of_element_located((By.ID, wait_for))WebDriverWait(self.browser, self.delay).until(element_present)except TimeoutException:sys.exit(error) def enter_login_details(self, email, password):try:print('Entering login details')email_field = self.browser.find_element_by_id('email')pass_field = self.browser.find_element_by_id('pass')email_field.send_keys(email)pass_field.send_keys(password)pass_field.submit()element_present = expected_conditions.presence_of_element_located((By.ID, 'userNavigationLabel'))WebDriverWait(self.browser, self.delay).until(element_present)except TimeoutException:sys.exit('Login with your credentials unsuccessful') def import_members(self, emails):print('Attempting to import email addresses')xpath = "//input[ ='Enter name or email address...']"add_members_field = self.browser.find_element_by_xpath(xpath)for email in emails:for c in email:add_members_field.send_keys(self._get_base_character(c))add_members_field.send_keys(Keys.RETURN)time.sleep(random.randint(1,self.delay)) @placeholder @staticmethoddef _get_base_character(c):desc = unicodedata.name(unicode(c))cutoff = desc.find(' WITH ')if cutoff != -1:desc = desc[:cutoff]return unicodedata.lookup(desc) This uses which is a query language for working with HTML documents. We search for the input by looking up the placeholder. We then loop through the array of email addresses to invite, entering each email address character by character. This prevents the browser from locking up on the input. After each email address submission the script waits for at least one second before continuing. Add usage of to and our automation script is complete. XPath add members import_members() main.py # main.py import argparseimport getpass from browser import Browserfrom email_loader import EmailLoader def main():parser = argparse.ArgumentParser(description='This tool lets you invite people in bulk to your Facebook group')parser.add_argument('-e','--email', help='Your personal Facebook account email', required=True)parser.add_argument('-g','--group', help='The Facebook group name', required=True)args = vars(parser.parse_args())args['password'] = getpass.getpass() email_loader = EmailLoader()browser = Browser()browser.navigate(url=' ,wait_for='facebook',error='Unable to load the Facebook website')browser.enter_login_details(args['email'], args['password'])browser.navigate(url=' + args['group'],wait_for='pagelet_group_',error='Couldn\'t navigate to the group\'s members page')browser.import_members(email_loader.emails)print('Import complete') https://www.facebook.com' https://www.facebook.com/groups/' if __name__ == '__main__':main() Wrap-up Python and Selenium make it painless to automate simple web tasks. Today we’ve been through just one use case but the possibilities are almost endless. Happy automating! For the source code check out the . repository on Github _facebook-bulk-group-inviter - Python CLI to import members to Facebook groups via email in bulk_github.com danielireson/facebook-bulk-group-inviter
