Advent of Code API client.
npm install aocjs[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href] [![jsdocs][jsdocs-src]][jsdocs-href]
Library for the Advent of Code API.
- Adds a User-Agent to identify as automated requests
- Written in TypeScript
š§ This project is under heavy development.
Install:
``sh`
[pnpm|npm|yarn|bun] install aocjs
At this point, you'll have to add your Advent of Code browser session key, this requires a few more
steps.
1. Open adventofcode.com and log in.
2. Open your Chrome or Firefox Devtools (F12).
3. Go to Application tab.
4. On the sidebar, under Storage section, expand Cookies and click on https://adventofcode.com.
5. Now you're seeing 3 cookies, one of them must be named session. Copy it's value.
`js
// ESM
import { Client } from "aocjs";
// CommonJS
const { Client } = require("aocjs");
const client = new Client({ session: "53727...." });
const input = await client.getInput(2023, 7);
console.log(input); // Your input
`
- [x] Fetching input ({year}/day/{day}/input`)
- [ ] Submitting answers
- [ ] Fetching private/global leaderboard
- [ ] Ratelimits to reduce load on the site
- [ ] Respect Eric's wishes for load wherever possible
Copyright (c) 2023 taskylizard. MIT Licensed.
[npm-version-src]:
https://img.shields.io/npm/v/aocjs?style=flat&labelColor=f38ba8&color=585b70&logoColor=white
[npm-version-href]: https://npmjs.com/package/aocjs
[npm-downloads-src]:
https://img.shields.io/npm/dm/aocjs?style=flat&labelColor=f38ba8&color=585b70&logoColor=white
[npm-downloads-href]: https://npmjs.com/package/aocjs
[jsdocs-src]:
https://img.shields.io/badge/jsDocs.io-reference-18181B?style=flat&labelColor=f38ba8&color=585b70&logoColor=white
[jsdocs-href]: https://www.jsdocs.io/package/aocjs