{"id":15448486,"url":"https://github.com/vasa-develop/marketingbird","last_synced_at":"2025-04-28T12:22:13.640Z","repository":{"id":99739252,"uuid":"272287927","full_name":"vasa-develop/MarketingBird","owner":"vasa-develop","description":"An open-source marketing tool to port/enagage your twitter follower base  ","archived":false,"fork":false,"pushed_at":"2020-06-14T22:41:25.000Z","size":200,"stargazers_count":6,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-30T09:31:33.417Z","etag":null,"topics":["marketing-automation","marketing-tool","marketing-tool-twitter","twitter","twitter-bot"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vasa-develop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-14T21:40:52.000Z","updated_at":"2023-11-22T17:23:11.000Z","dependencies_parsed_at":"2023-07-31T18:46:20.771Z","dependency_job_id":null,"html_url":"https://github.com/vasa-develop/MarketingBird","commit_stats":{"total_commits":277,"total_committers":11,"mean_commits":"25.181818181818183","dds":0.4945848375451264,"last_synced_commit":"9fcb6c80cbb0b2d7266de0dfaad8cae2a1e64782"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vasa-develop%2FMarketingBird","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vasa-develop%2FMarketingBird/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vasa-develop%2FMarketingBird/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vasa-develop%2FMarketingBird/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vasa-develop","download_url":"https://codeload.github.com/vasa-develop/MarketingBird/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251311484,"owners_count":21569045,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["marketing-automation","marketing-tool","marketing-tool-twitter","twitter","twitter-bot"],"created_at":"2024-10-01T20:27:33.937Z","updated_at":"2025-04-28T12:22:13.619Z","avatar_url":"https://github.com/vasa-develop.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MarketingBird, An open-source marketing tool to port/enagage your twitter follower base\n\n## Ongoing Work\n\nThe plan here is to build something like Zapier so that the users can create multiple flows and join them to get desired results.\nThis model can be scaled over other social media platforms too.\n\nHere is the list of work we/I are/am doing, so that you can checkup our status:  \n\n- Working CLI tool (Works with a single command) **[DONE]**: [DEMO](https://github.com/balajis/twitter-export/issues/1#issuecomment-643811801)\n- There is an alternative codebase (much cleaner) on [blubird branch](https://github.com/vasa-develop/MarketingBird/tree/bluebird) **[DONE]**\n- Mockup for Zapier like interface for Dasboard UI **[DONE]**: [Youtube Video](https://youtu.be/16cJlX578gs)\n- Creating a easy-to-use flow, so that anybody can start getting more info about their userbase. **[PENDING]**\n  - A MarketingBird flow to scrape all the public data about an accounts followers and exporting it in user-firendly formats (spreadsheets, etc.)**[PENDING]**\n  - A Dashbaord to analyse your scapred data (charts, comparisons, all analytics stuff)**[PENDING]**\n  - A MarketingBird flow to use a spreadsheet (or a stream of data from another MarketingBird flow) to send DMs. We should be able to filter out the accounts with specific conditions (followers \u003e 1000, or interested in #Bitcoin)**[PENDING]**\n  - More stuff to be planned...\n\n\n## Setup\n\nYou need to prepare API keys at first.\nGo to [the front page](https://apps.twitter.com/), create a new app, and generate a new access token.\n\nThen put them as a key file at `~/.tweet.client.key`, with the format:\n\n```\nMY_SCREEN_NAME=xxxxxxxxxxxxxxxxxxx\nMY_LANGUAGE=xx\nCONSUMER_KEY=xxxxxxxxxxxxxxxxxxx\nCONSUMER_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\nACCESS_TOKEN_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n```\n\nIf there is a key file named `tweet.client.key` in the current directory, `tweet.sh` will load it.\nOtherwise, the file `~/.tweet.client.key` will be used as the default key file.\n\nMoreover, you can give those information via environment variables without a key file.\n\n```\n$ export MY_SCREEN_NAME=xxxxxxxxxxxxxxxxxxx\n$ export MY_LANGUAGE=xx\n$ export CONSUMER_KEY=xxxxxxxxxxxxxxxxxxx\n$ export CONSUMER_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n$ export ACCESS_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n$ export ACCESS_TOKEN_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n$ ./tweet.sh post \"Hello!\"\n```\n\nThis form will be useful to implement a bot program.\n\nAnd, this script uses some external commands.\nYou need to install them via package system on your environment: `apt`, `yum` or something.\nRequired commands are:\n\n- `curl`\n- `jq`\n- `nkf`\n- `openssl`\n\nNow go to the [followers.py]() and add the credentials here too.\n\n```\nconsumer_key = \"consumer_key_here\"\nconsumer_secret = \"consumer_secret_here\"\naccess_key = \"access_key_here\"\naccess_secret = \"access_secret_here\"\n```\n\nThat's it!\n\n## Usage\n\n```\npython followers.py -a \u003ctwitter_handle\u003e \u003ccvs_file_name_to_store_follower_details\u003e\n\n// For eg\n\npython followers.py -a simpleaswater_ followers.csv\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvasa-develop%2Fmarketingbird","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvasa-develop%2Fmarketingbird","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvasa-develop%2Fmarketingbird/lists"}