NijiHolo_EN_ID_Bot/README.md

# NijiHolo_EN_ID_Bot
*Twitter bot that follows interactions between Nijisanji EN/ID and hololive EN/ID members.*  
...because some folks are that desperate. Like me!

**This project is intended to run [this account](https://twitter.com/NijiHolo_EN_ID).**

## Roadmap
* Read past tweets of members from both companies
* Track tweets in queue and history/log files
* Create image of tweet, including up to three image attachments from that tweet
* Combine image(s) with quote retweet
* Don't tweet already-existing tweets (check our past quote RTs; might be saved in a file for quicker access)
* Listen for live tweets as soon as they post

## Notes
* Tweets should only occur if involved parties are cross-company
* Tweets should only occur if interaction involves [EN and EN] or [EN and (former) ID] parties
    * cross-company ID interactions are regular enough
* Text of our tweet should include involved names (w/o @) and the message, up to our tweet limit
    * this, along with image, helps archive deleted tweets

## API Calls
**retrieving tweets from a user**

https://oauth-playground.glitch.me/?id=usersIdTweets
* `id`: user
* `max_results=100`: 100 is the highest number of tweets we can retrieve
* `pagination_token`: token that takes us to the next/prev page of tweets
    * use `meta[next_token]`
* `expansions=entities.mentions.username,in_reply_to_user_id`
    * exposes mentions and replied users