Carousell is both a library and CLI tool written in Golang that fetches Carousell listings and notifies users.
Using Carousell is easy. First, use go install
to install the latest version of the executable. This command will install the carousell
executable in $GOPATH/bin
:
go install github.com/rodionlim/carousell@latest
To use the library, go get
will install the libraries and dependencies for your project.
go get github.com/rodionlim/carousell
Later, to receive updates, run
go get -u github.com/rodionlim/carousell
There are two commands, get
and notify
. Flags can be used to modify the search behaviour, e.g. -r
flag will query for only recent listings, -v
flag represents verbose mode and add logging to the output
get
will fetch the listings and output them to the console.
carousell get "nintendo switch" -r
notify
will periodically fetch the listings, and notify users on new listings in Slack. For slack to work, the environment variable SLACK_ACCESS_TOKEN
has to be set and the appropriate permissions granted, e.g. inviting the application to the slack channel
carousell notify --slack-channel=CHANNEL_ID "nintendo switch" -r
To get help on the available flags, use the -h
flag.
carousell -h
The following Go code generates the latest 20 listing based on key words specified
r := carousell.NewReq(crs.WithSearch("nintendo switch"))
r.Get()
Carousell is released under the Apache 2.0 license. See LICENSE