@mistereman22/osrs-wiki-mcp-server 1.0.2 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBzD"}
1
+ {"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAyEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBzD"}
package/dist/resources.js CHANGED
@@ -6,42 +6,74 @@ import { readFile } from 'node:fs/promises';
6
6
  import { fileURLToPath } from 'node:url';
7
7
  const RESOURCES = [
8
8
  {
9
- name: 'bucket-index',
10
- uri: 'context://bucket-index',
11
- file: fileURLToPath(new URL('../../resources/bucket-index.md', import.meta.url)),
12
- title: 'Bucket Index',
13
- description: 'Curated hint list of known Bucket buckets on the OSRS wiki (names, query forms, purposes). Not authoritative - if nothing matches, fall back to discovery via search-page-by-prefix in the Bucket: namespace.',
9
+ name: 'tool-selection',
10
+ uri: 'context://tool-selection',
11
+ file: fileURLToPath(new URL('../../resources/tool-selection.md', import.meta.url)),
12
+ title: 'Tool Selection Guide',
13
+ description: 'Top-level routing: which tool to use for each question type. Decision tree mapping queries to tools + required resources. Read this FIRST.',
14
14
  mimeType: 'text/markdown',
15
15
  },
16
16
  {
17
- name: 'wiki-navigation',
18
- uri: 'context://wiki-navigation',
19
- file: fileURLToPath(new URL('../../resources/wiki-navigation.md', import.meta.url)),
20
- title: 'Wiki Navigation Guide',
21
- description: 'How to find pages on the OSRS Wiki: namespaces, category structure, redirect handling, disambiguation patterns, and page structure by type.',
17
+ name: 'bucket-catalog',
18
+ uri: 'context://bucket-catalog',
19
+ file: fileURLToPath(new URL('../../resources/bucket-catalog.md', import.meta.url)),
20
+ title: 'Bucket Catalog',
21
+ description: 'Complete reference list of all known Bucket buckets on the OSRS Wiki with query names, page titles, and contents. For usage patterns, see bucket-query-guide.',
22
22
  mimeType: 'text/markdown',
23
23
  },
24
24
  {
25
- name: 'search-strategies',
26
- uri: 'context://search-strategies',
27
- file: fileURLToPath(new URL('../../resources/search-strategies.md', import.meta.url)),
28
- title: 'Search Strategies',
29
- description: 'When and how to use search-page, search-page-by-prefix, and get-page metadata for efficient wiki queries. Includes decision tree and common patterns.',
25
+ name: 'bucket-query-guide',
26
+ uri: 'context://bucket-query-guide',
27
+ file: fileURLToPath(new URL('../../resources/bucket-query-guide.md', import.meta.url)),
28
+ title: 'Bucket Query Guide',
29
+ description: 'How to use bucket-query effectively: when to use it, mandatory best practices, exact-match rules, common patterns, limitations, and troubleshooting.',
30
+ mimeType: 'text/markdown',
31
+ },
32
+ {
33
+ name: 'namespace-category-guide',
34
+ uri: 'context://namespace-category-guide',
35
+ file: fileURLToPath(new URL('../../resources/namespace-category-guide.md', import.meta.url)),
36
+ title: 'Namespace & Category Guide',
37
+ description: 'Category structure, namespace IDs, DPL/template discovery workflow for get-category-members, get-site-info, get-links-here. When to use category vs search.',
38
+ mimeType: 'text/markdown',
39
+ },
40
+ {
41
+ name: 'search-guide',
42
+ uri: 'context://search-guide',
43
+ file: fileURLToPath(new URL('../../resources/search-guide.md', import.meta.url)),
44
+ title: 'Search Guide',
45
+ description: 'Tool selection, broad-first search strategy, canonical page heuristic, section discovery for search-page, search-page-by-prefix, get-page. Includes decision tree and fallback chain.',
46
+ mimeType: 'text/markdown',
47
+ },
48
+ {
49
+ name: 'page-structure',
50
+ uri: 'context://page-structure',
51
+ file: fileURLToPath(new URL('../../resources/page-structure.md', import.meta.url)),
52
+ title: 'Page Structure Guide',
53
+ description: 'Page types, key sections, infobox-to-bucket mapping for get-page. Redirects, disambiguation, large page strategy, common prefixes.',
30
54
  mimeType: 'text/markdown',
31
55
  },
32
56
  ];
57
+ import { logger } from '@professional-wiki/mediawiki-mcp-server/dist/runtime/logger.js';
33
58
  export function registerResources(server) {
34
59
  for (const resource of RESOURCES) {
60
+ logger.debug(`Registering resource: ${resource.name} -> ${resource.file}`);
35
61
  server.registerResource(resource.name, resource.uri, {
36
62
  title: resource.title,
37
63
  description: resource.description,
38
64
  mimeType: resource.mimeType,
39
65
  }, async (uri) => {
40
- const text = await readFile(resource.file, 'utf8');
41
- const href = typeof uri === 'string' ? uri : uri.href;
42
- return {
43
- contents: [{ uri: href, mimeType: resource.mimeType, text }],
44
- };
66
+ try {
67
+ const text = await readFile(resource.file, 'utf8');
68
+ const href = typeof uri === 'string' ? uri : uri.href;
69
+ return {
70
+ contents: [{ uri: href, mimeType: resource.mimeType, text }],
71
+ };
72
+ }
73
+ catch (error) {
74
+ logger.error(`Failed to read resource ${resource.name} from ${resource.file}: ${error instanceof Error ? error.message : String(error)}`);
75
+ throw error;
76
+ }
45
77
  });
46
78
  }
47
79
  }
@@ -1 +1 @@
1
- {"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAWzC,MAAM,SAAS,GAAqB;IACnC;QACC,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,wBAAwB;QAC7B,IAAI,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,iCAAiC,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QAChF,KAAK,EAAE,cAAc;QACrB,WAAW,EACV,+MAA+M;QAChN,QAAQ,EAAE,eAAe;KACzB;IACD;QACC,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,2BAA2B;QAChC,IAAI,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,oCAAoC,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnF,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACV,6IAA6I;QAC9I,QAAQ,EAAE,eAAe;KACzB;IACD;QACC,IAAI,EAAE,mBAAmB;QACzB,GAAG,EAAE,6BAA6B;QAClC,IAAI,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,sCAAsC,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACrF,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACV,uJAAuJ;QACxJ,QAAQ,EAAE,eAAe;KACzB;CACD,CAAC;AAIF,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IAClD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,gBAAgB,CACtB,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,GAAG,EACZ;YACC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC3B,EACD,KAAK,EAAE,GAAiB,EAAE,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YACtD,OAAO;gBACN,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;aAC5D,CAAC;QACH,CAAC,CACD,CAAC;IACH,CAAC;AACF,CAAC"}
1
+ {"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA2BA,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAM5C,cAAM,oBAAoB;;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAKlF;IAQK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB7B;CACD;AASD,eAAO,MAAM,eAAe,sBAK3B,CAAC;AAyDF,eAAO,MAAM,WAAW,yBAAyB,CAAC;AAClD,eAAO,MAAM,cAAc,UAAU,CAAC;AA4DtC;;GAEG;AACH,OAAO,UAAU,CAAC;AAElB,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAWzD,wBAAsB,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,CAgDtD"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AA2BA,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAM5C,cAAM,oBAAoB;;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAKlF;IAQK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB7B;CACD;AASD,eAAO,MAAM,eAAe,sBAK3B,CAAC;AAyDF,eAAO,MAAM,WAAW,yBAAyB,CAAC;AAClD,eAAO,MAAM,cAAc,UAAU,CAAC;AAwFtC;;GAEG;AACH,OAAO,UAAU,CAAC;AAElB,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAWzD,wBAAsB,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,CAgDtD"}
package/dist/server.js CHANGED
@@ -118,8 +118,36 @@ const SERVER_INSTRUCTIONS = [
118
118
  'The wiki target is fixed by the package: no tool can add, remove, or switch wikis.',
119
119
  'Deployment is read-only and anonymous. Outbound calls use User-Agent `' + BASE_USER_AGENT + ' <MCP_CONTACT>\`.',
120
120
  'MediaWiki tools follow upstream behavior from @professional-wiki/mediawiki-mcp-server.',
121
- 'For structured data (item/monster stats, prices, drops, quest info, gear recommendations) PREFER \'bucket-query\' over reading wiki pages: buckets return semantic rows directly. BEFORE any bucket-query, read \'context://bucket-index\' to find the correct bucket name and fields - it costs no API traffic. If no match there, fall back to runtime discovery - \'search-page-by-prefix\' in the Bucket: namespace, then \'get-page\' for the schema.',
122
- 'For wiki navigation and search strategy: read \'context://wiki-navigation\' (namespaces, categories, page structure) and \'context://search-strategies\' (tool selection, section discovery) before searching.',
121
+ '',
122
+ 'TOOL SELECTION — DECIDE FIRST, THEN READ THE RELEVANT RESOURCE:',
123
+ '',
124
+ '| If the user asks for... | Use this tool | Read this resource first |',
125
+ '|-------------------------|---------------|--------------------------|',
126
+ '| Structured data: item stats, GE prices, monster stats, drop rates, quest requirements, gear recommendations, varbits, shop info | bucket-query | context://bucket-catalog (find bucket + fields), then context://bucket-query-guide (usage patterns) |',
127
+ '| Canonical lists: all bosses, all quests, all items, all updates, all monsters in category | get-category-members | context://namespace-category-guide (category structure, namespace IDs) |',
128
+ '| Pages in a custom namespace (e.g., Update: game updates) | get-site-info + get-category-members | context://namespace-category-guide (DPL/template discovery workflow) |',
129
+ '| Unstructured content: lore, mechanics, walkthroughs, guides | search-page / get-page | context://search-guide (broad-first, canonical page heuristic) |',
130
+ '| Exact page title known | get-page | context://page-structure (page types, sections) |',
131
+ '| Backlinks / transclusions / file usage | get-links-here | context://namespace-category-guide |',
132
+ '',
133
+ 'START HERE: Read context://tool-selection first for the complete decision tree and quick patterns.',
134
+ '',
135
+ 'MANDATORY: Read the relevant resource BEFORE using each tool:',
136
+ '',
137
+ 'For search-page, search-page-by-prefix:',
138
+ ' 1. context://search-guide — tool selection, broad-first search, canonical page heuristic, rate limits',
139
+ '',
140
+ 'For get-page:',
141
+ ' 1. context://search-guide — section discovery via metadata=true + section=N',
142
+ ' 2. context://page-structure — page structure by type, redirects, disambiguation',
143
+ '',
144
+ 'For get-category-members, get-site-info, get-links-here:',
145
+ ' 1. context://namespace-category-guide — category structure, namespace IDs, DPL/template discovery workflow',
146
+ '',
147
+ 'For bucket-query:',
148
+ ' 1. context://bucket-catalog — find correct bucket name and fields (costs no API traffic)',
149
+ ' 2. context://bucket-query-guide — mandatory best practices, exact-match rules, common patterns, limitations',
150
+ '',
123
151
  'CRITICAL: ALWAYS use .select() and .where() in bucket-query. NEVER run unfiltered queries - they return thousands of rows, bloat context, and strain the wiki. ALWAYS use .select("field1","field2") to limit columns and .where("field","value") to filter rows. Use .limit(N) for pagination.',
124
152
  'bucket-query uses EXACT MATCH ONLY - no wildcards. To find exact values: 1) search-page for the term, 2) use exact result in bucket-query. Example: "Bob\'s Axe Shop" -> search-page "bob axe" -> gets "Bob\'s Brilliant Axes" -> bucket("infobox_shop").where("shop_name","Bob\'s Brilliant Axes")',
125
153
  'If a bucket query returns no results: CHECK THE SCHEMA (get-page Bucket:<name>) - wrong field name or wrong exact value. Fix the query. If the bucket schema does not support your query (e.g., dropsline only queryable by item_name, not source), use the appropriate wiki page directly.',
@@ -129,7 +157,7 @@ const SERVER_INSTRUCTIONS = [
129
157
  ' * Monster stats -> bucket("infobox_monster").select("name","combat_level","hitpoints").where("name","Hydra").run()',
130
158
  ' * Item stats -> bucket("infobox_item").select("item_name","value","high_alch").where("item_name","Abyssal whip").run()',
131
159
  ' * Drop sources for an item -> bucket("dropsline").select("item_name","drop_json").where("item_name","Abyssal whip").run() (drop_json contains "Dropped from" as JSON text)',
132
- ' * What drops from a source (boss/chest/activity) -> bucket CANNOT do this; use get-page on the source page directly (see context://bucket-index for patterns)',
160
+ ' * What drops from a source (boss/chest/activity) -> bucket CANNOT do this; use get-page on the source page directly (see context://bucket-query-guide for patterns)',
133
161
  ' * Quest requirements -> bucket("quest").select("name","requirements").where("name","Dragon Slayer I").run()',
134
162
  ' * Varbits -> bucket("varbit").select("name","value").where("name","hydra_task").run()',
135
163
  ' * Shop lookup -> bucket("infobox_shop").select("shop_name","location","owner").where("shop_name","Bob\'s Brilliant Axes").run()',
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mistereman22/osrs-wiki-mcp-server",
3
- "version": "1.0.2",
3
+ "version": "1.0.4",
4
4
  "description": "MCP server for the Old School RuneScape Wiki: the full MediaWiki MCP tool surface against a pinned read-only wiki.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -0,0 +1,82 @@
1
+ # Bucket Catalog (Reference)
2
+
3
+ > Complete list of known buckets on OSRS Wiki. For usage patterns, see `context://bucket-query-guide`.
4
+
5
+ ## Bucket Index
6
+
7
+ | Query as | Page | Holds |
8
+ | --- | --- | --- |
9
+ | `bucket("bountytaskline")` | Bucket:Bountytaskline | Bounty Hunter task line entries |
10
+ | `bucket("clue_equipment")` | Bucket:Clue equipment | Equipment associated with clue scroll steps |
11
+ | `bucket("clue_info")` | Bucket:Clue info | Clue scroll metadata/step info |
12
+ | `bucket("collection_log_source")` | Bucket:Collection log source | Collection log sources per item: item_id, item_name, sources, rates, kinds. **Only queryable by item_name** |
13
+ | `bucket("combat_achievement")` | Bucket:Combat achievement | Combat achievement tasks, tiers, requirements |
14
+ | `bucket("couriertaskline")` | Bucket:Couriertaskline | Courier activity task line entries |
15
+ | `bucket("demonicpactleaguetask")` | Bucket:Demonicpactleaguetask | Demonic Pact league task entries |
16
+ | `bucket("dependency_list")` | Bucket:Dependency list | Item/object dependency relations |
17
+ | `bucket("drop_table_sources")` | Bucket:Drop table sources | Shared drop tables (rare, gem, herb) and roll/rarity data |
18
+ | `bucket("dropsline")` | Bucket:Dropsline | Drop table line entries: item_name, drop_json (JSON with "Dropped from", rarity, quantity). **Only queryable by item_name** |
19
+ | `bucket("exchange")` | Bucket:Exchange | Grand Exchange prices (name, value, high/low, volumes) |
20
+ | `bucket("feedback")` | Bucket:Feedback | Wiki feedback entries (site-internal) |
21
+ | `bucket("ge_index_header")` | Bucket:Ge index header | GE index header/snapshot metadata |
22
+ | `bucket("infobox_activity")` | Bucket:Infobox activity | Skilling/activity infobox data |
23
+ | `bucket("infobox_bonuses")` | Bucket:Infobox bonuses | Equipment combat stats and bonuses |
24
+ | `bucket("infobox_construction")` | Bucket:Infobox construction | Construction object/buildable data |
25
+ | `bucket("infobox_grid_master_unlock")` | Bucket:Infobox grid master unlock | Grid Master unlock data |
26
+ | `bucket("infobox_item")` | Bucket:Infobox item | Core item data: item_name, item_id, examine, high_alchemy_value, value, weight, buy_limit, is_members_only, tradeable, image, league_region, release_date, removal_date, quest, version_anchor |
27
+ | `bucket("infobox_location")` | Bucket:Infobox location | Location/area data |
28
+ | `bucket("infobox_monster")` | Bucket:Infobox monster | Monster combat stats: name, combat_level, hitpoints, max_hit, slayer_level, slayer_experience, slayer_category, assigned_by, attack/defence bonuses, attack_speed, poisonous, attribute, attack_style, respawn_time, experience_bonus, flat_armour, magic_resistance, size, attack/strength/defence/ranged/magic levels, attack_bonus, strength_bonus, range_strength_bonus, magic_damage_bonus, poison/venom/freeze/burn/cannon/thrall resistance, elemental_weakness, elemental_weakness_percent |
29
+ | `bucket("infobox_npc")` | Bucket:Infobox npc | NPC data: id, combat level, examine |
30
+ | `bucket("infobox_pure")` | Bucket:Infobox pure | Pure-entity infobox data (verify schema) |
31
+ | `bucket("infobox_scenery")` | Bucket:Infobox scenery | Scenery/object entity data |
32
+ | `bucket("infobox_ship_part")` | Bucket:Infobox ship part | Ship part data |
33
+ | `bucket("infobox_shop")` | Bucket:Infobox shop | Shop data: shop_name, location, owner, specialty, shop_version, is_members_only |
34
+ | `bucket("infobox_spell")` | Bucket:Infobox spell | Spell data: requirements, effects, costs |
35
+ | `bucket("interface")` | Bucket:Interface | Game interface definitions |
36
+ | `bucket("item_id")` | Bucket:Item id | Item name to id mappings |
37
+ | `bucket("locline")` | Bucket:Locline | Location line entries |
38
+ | `bucket("logs")` | Bucket:Logs | Woodcutting log/tree data |
39
+ | `bucket("map")` | Bucket:Map | Map marker/region data |
40
+ | `bucket("mine")` | Bucket:Mine | Mining node/rock data |
41
+ | `bucket("mmg_output")` | Bucket:Mmg output | Money making guide output calculations |
42
+ | `bucket("money_making_guide")` | Bucket:Money making guide | Money making methods: profit, requirements |
43
+ | `bucket("music")` | Bucket:Music | Music track unlock data |
44
+ | `bucket("music_file")` | Bucket:Music file | Music file metadata |
45
+ | `bucket("music_map")` | Bucket:Music map | Music tracks by region/map area |
46
+ | `bucket("music_versions")` | Bucket:Music versions | Music version/history entries |
47
+ | `bucket("npc_id")` | Bucket:Npc id | NPC name to id mappings |
48
+ | `bucket("object_id")` | Bucket:Object id | Object/scenery id mappings |
49
+ | `bucket("quest")` | Bucket:Quest | Quest data: requirements, rewards, difficulty |
50
+ | `bucket("recipe")` | Bucket:Recipe | Creation/processing recipes: inputs, outputs, skills |
51
+ | `bucket("recommended_equipment")` | Bucket:Recommended equipment | Recommended gear setups by activity/slot (schema not available on page - use runtime discovery) |
52
+ | `bucket("seachart")` | Bucket:Seachart | Sea chart/naval data |
53
+ | `bucket("sound_effect")` | Bucket:Sound effect | Sound effect metadata |
54
+ | `bucket("soundtrack")` | Bucket:Soundtrack | Soundtrack track data |
55
+ | `bucket("storeline")` | Bucket:Storeline | Store line entries |
56
+ | `bucket("testing_bucket")` | Bucket:Testing bucket | Wiki-internal testing data (not real content) |
57
+ | `bucket("transcript")` | Bucket:Transcript | NPC/dialogue transcripts |
58
+ | `bucket("update")` | Bucket:Update | Game update records: dates, summaries |
59
+ | `bucket("varbit")` | Bucket:Varbit | Varbit id to meaning mappings |
60
+
61
+ ## Quick Reference: Common Tasks → Bucket
62
+
63
+ | Task | Bucket |
64
+ |------|--------|
65
+ | GE prices | `bucket("exchange")` |
66
+ | Item stats (examine, weight, alch, buy limit) | `bucket("infobox_item")` |
67
+ | Monster stats (HP, max hit, combat level, weaknesses) | `bucket("infobox_monster")` |
68
+ | Drop sources for item | `bucket("dropsline")` |
69
+ | Quest requirements/rewards | `bucket("quest")` |
70
+ | Gear for activity | `bucket("recommended_equipment")` |
71
+ | Varbit values | `bucket("varbit")` |
72
+ | Shop info | `bucket("infobox_shop")` |
73
+ | Item/NPC/Object ID lookups | `bucket("item_id")`, `bucket("npc_id")`, `bucket("object_id")` |
74
+ | Combat achievements | `bucket("combat_achievement")` |
75
+ | Equipment bonuses | `bucket("infobox_bonuses")` |
76
+ | Money making methods | `bucket("money_making_guide")` |
77
+
78
+ ## Discovery
79
+
80
+ If a bucket isn't listed here:
81
+ 1. `search-page-by-prefix "Bucket:"` (namespace 9592)
82
+ 2. `get-page "Bucket:<Name>"` for schema + preview
@@ -0,0 +1,140 @@
1
+ # Bucket Query Guide
2
+
3
+ > How to use bucket-query effectively. Read `context://bucket-catalog` first to find the right bucket.
4
+
5
+ ## When to Use bucket-query
6
+
7
+ **Use bucket-query for structured/semantic data. Use search-page/get-page for unstructured content.**
8
+
9
+ | Use bucket-query for... | Use search-page/get-page for... |
10
+ |-------------------------|--------------------------------|
11
+ | Item stats (price, high alch, weight, examine, buy limit) | Lore, mechanics, walkthroughs |
12
+ | Monster stats (HP, max hit, combat level, weaknesses, slayer info) | "How do I..." guides |
13
+ | Grand Exchange prices | General explanations |
14
+ | Drop sources for a specific item | Narrative content |
15
+ | Quest requirements, rewards, difficulty | |
16
+ | Gear recommendations for an activity/boss | |
17
+ | Varbit values/meanings | |
18
+ | Shop info (location, owner, stock) | |
19
+ | Item/NPC/Object ID mappings | |
20
+
21
+ **Key distinction**: Buckets return *structured rows* (semantic data). Pages return *wikitext/HTML* (unstructured content).
22
+
23
+ ## Mandatory Best Practices
24
+
25
+ - **ALWAYS use `.select("field1","field2")`** — only fetch needed columns
26
+ - **ALWAYS use `.where("field","value")`** — filter rows, never fetch all
27
+ - **Use `.limit(N)`** — cap results (max 500)
28
+ - **Chain filters** with `Bucket.And/Or/Not` for complex conditions
29
+ - **NEVER run `.run()` without `.select()` and `.where()`**
30
+
31
+ ```lua
32
+ -- ✅ Good
33
+ bucket("exchange").select("name","value","high_alch").where("name","Abyssal whip").run()
34
+ bucket("infobox_shop").select("shop_name","location").where("location","Lumbridge").limit(100).run()
35
+
36
+ -- ❌ Bad (causes context bloat)
37
+ bucket("infobox_shop").run()
38
+ bucket("exchange").select("*").run()
39
+ ```
40
+
41
+ ## Exact Match Only — No Wildcards
42
+
43
+ bucket-query uses **exact match only**. To find exact values:
44
+
45
+ 1. `search-page` for the term → get exact name
46
+ 2. Use exact name in bucket query with `.where()`
47
+
48
+ ```bash
49
+ # Example: "Bob's Axe Shop"
50
+ search-page "bob axe" → "Bob's Brilliant Axes"
51
+ bucket("infobox_shop").where("shop_name","Bob's Brilliant Axes")
52
+ ```
53
+
54
+ ## Query Syntax
55
+
56
+ ```lua
57
+ -- Equality
58
+ .where("field","value")
59
+
60
+ -- Operators
61
+ .where({"field",">",value})
62
+ .where({"field","<",value})
63
+ .where({"field",">=",value})
64
+ .where({"field","<=",value})
65
+ .where({"field","!=",value})
66
+
67
+ -- Composition
68
+ Bucket.And({where1, where2})
69
+ Bucket.Or({where1, where2})
70
+ Bucket.Not(where1)
71
+
72
+ -- Pagination
73
+ .limit(200).continueFrom("cursor")
74
+ ```
75
+
76
+ Full Lua reference: https://meta.weirdgloop.org/w/Extension:Bucket/Usage
77
+
78
+ ## Common Patterns (Always use .select() and .where())
79
+
80
+ | Task | Query |
81
+ |------|-------|
82
+ | GE prices | `bucket("exchange").select("name","value","high_alch").where("name","Abyssal whip").run()` |
83
+ | Monster stats | `bucket("infobox_monster").select("name","combat_level","hitpoints","max_hit").where("name","Hydra").run()` |
84
+ | Item stats | `bucket("infobox_item").select("item_name","value","high_alch","weight","buy_limit").where("item_name","Abyssal whip").run()` |
85
+ | Drop sources for item | `bucket("dropsline").select("item_name","drop_json").where("item_name","Abyssal whip").run()` |
86
+ | Quest requirements | `bucket("quest").select("name","requirements","rewards").where("name","Dragon Slayer I").run()` |
87
+ | Varbits | `bucket("varbit").select("name","value").where("name","hydra_task").run()` |
88
+ | Shop lookup | `bucket("infobox_shop").select("shop_name","location","owner").where("shop_name","Bob's Brilliant Axes").run()` |
89
+ | Gear recommendations | `bucket("recommended_equipment").select("item","slot").where("activity","hydra").run()` |
90
+ | Equipment bonuses | `bucket("infobox_bonuses").select("name","slot","stab","slash","crush","magic","range").where("name","Bandos chestplate").run()` |
91
+ | Combat achievements | `bucket("combat_achievement").select("name","tier","description").where("name","Perfect Fire Cape").run()` |
92
+
93
+ ## Workflow: Find Exact Values First
94
+
95
+ 1. **search-page** for term → get exact name
96
+ 2. Use exact name in `bucket-query` with `.where()`
97
+
98
+ ```bash
99
+ # "best gear for hydra"
100
+ search-page "hydra gear" → exact activity name "Hydra"
101
+ bucket("recommended_equipment").select("item","slot").where("activity","Hydra").run()
102
+ ```
103
+
104
+ ## What Buckets CANNOT Do
105
+
106
+ | Limitation | Workaround |
107
+ |------------|------------|
108
+ | `dropsline` only queryable by `item_name`, not by source | Use `get-page` on source page (boss/chest/activity) |
109
+ | "What drops from boss X" | `get-page "Boss Name"` → `metadata=true` → `section=N` for drops |
110
+ | Raid/group drops (ToA, CoX, ToB) | Individual boss/chest pages via `get-page` |
111
+
112
+ ## Raid/Group Drop Patterns (use get-page, NOT buckets)
113
+
114
+ | Content | Query |
115
+ |---------|-------|
116
+ | Tombs of Amascut (ToA) | `get-page "Chest (Tombs of Amascut)"` then `get-page "Tumeken's Warden"`, `get-page "Akkha"`, etc. |
117
+ | Chambers of Xeric (CoX) | `get-page "Chambers of Xeric"` then individual boss pages (Olm, Great Olm, etc.) |
118
+ | Theatre of Blood (ToB) | `get-page "Theatre of Blood"` then individual boss pages (Maiden, Bloat, Nylocas, Sotetseg, Xarpus, Verzik) |
119
+ | General boss drops | `get-page "<Boss Name>"` (e.g., "Zulrah", "Vorkath", "Phantom Muspah") |
120
+
121
+ For large pages: `get-page "<Title>" metadata=true` → get section outline → `get-page "<Title>" section=N` for drops section.
122
+
123
+ ## Troubleshooting
124
+
125
+ | Issue | Fix |
126
+ |-------|-----|
127
+ | No results | Check schema: `get-page "Bucket:<Name>"` — wrong field name or wrong exact value |
128
+ | Too many results | Add more `.where()` filters, use `.limit()` |
129
+ | Schema not available | Use `search-page-by-prefix "Bucket:"` → find schema page |
130
+ | Field name unknown | Read bucket schema page for exact field names |
131
+
132
+ ## Pagination Example
133
+
134
+ ```lua
135
+ -- First page
136
+ bucket("infobox_shop").select("shop_name","location").limit(200).run()
137
+
138
+ -- Subsequent pages
139
+ bucket("infobox_shop").select("shop_name","location").limit(200).continueFrom("cursor_from_previous").run()
140
+ ```
@@ -0,0 +1,154 @@
1
+ # Namespace & Category Guide
2
+
3
+ > Category structure, namespace IDs, and DPL/template discovery workflow for `get-category-members`, `get-site-info`, `get-links-here`.
4
+
5
+ ## Namespaces
6
+
7
+ | Namespace ID | Prefix | Purpose |
8
+ |--------------|--------|---------|
9
+ | 0 | (none) | Main content pages (items, monsters, quests, bosses, mechanics) |
10
+ | 1 | Talk: | Discussion pages |
11
+ | 2 | User: | User pages |
12
+ | 6 | File: | Images/media |
13
+ | 10 | Template: | Templates |
14
+ | 14 | Category: | Category listings |
15
+ | 9592 | Bucket: | Bucket extension schemas (use `context://bucket-catalog` first) |
16
+ | 1198 | Update: | Game updates (DPL-driven lists) |
17
+ | 1199 | Update_talk: | Update discussion |
18
+ | 1200 | Calculator: | Calculators |
19
+ | 828 | Module: | Lua modules |
20
+
21
+ > **Tip**: Run `get-site-info` for the full namespace map — custom namespaces vary by wiki.
22
+
23
+ ## Category Structure (Key Categories)
24
+
25
+ ### Items
26
+ - `Category:Items` → subcategories: `Weapons`, `Armour`, `Food`, `Potions`, `Runes`, `Ammunition`, `Tools`, `Quest items`, etc.
27
+ - `Category:Tradeable items` / `Category:Untradeable items`
28
+ - `Category:Grand Exchange items`
29
+
30
+ ### Monsters/NPCs
31
+ - `Category:Monsters` → subcategories: `Bosses`, `Slayer monsters`, `Dungeon monsters`, `Wilderness monsters`
32
+ - `Category:Aggressive monsters`, `Category:Poisonous monsters`
33
+
34
+ ### Content
35
+ - `Category:Quests` → `Free-to-play quests`, `Members quests`, `Novice/Intermediate/Experienced/Master/Grandmaster quests`
36
+ - `Category:Achievement Diaries`, `Category:Combat Achievements`
37
+ - `Category:Minigames`, `Category:Raids`, `Category:Activities`
38
+ - `Category:Locations`, `Category:Dungeons`, `Category:Cities`
39
+
40
+ ### Data
41
+ - `Category:Exchange` (GE price pages)
42
+ - `Category:Drop tables`
43
+
44
+ ## When to Use get-category-members vs search-page
45
+
46
+ | Use `get-category-members` when... | Use `search-page` when... |
47
+ |------------------------------------|---------------------------|
48
+ | You want *all* pages in a category | You want pages *about* a topic |
49
+ | The category is the canonical list | You don't know the category |
50
+ | You need namespace filtering (e.g., Update: pages) | You need full-text matching |
51
+ | Example: "list all bosses" | Example: "hydra gear setup" |
52
+
53
+ ## Tool Routing
54
+
55
+ | Goal | Tool | Parameters |
56
+ |------|------|------------|
57
+ | **All bosses** | `get-category-members` | `category="Bosses"` |
58
+ | **All quests** | `get-category-members` | `category="Quests"` |
59
+ | **All items** | `get-category-members` | `category="Items"` |
60
+ | **All game updates** | `get-category-members` | `category="Updates" namespaces=[1198]` |
61
+ | **All calculators** | `get-category-members` | `category="Calculators" namespaces=[1200]` |
62
+ | **All GE-tracked items** | `get-category-members` | `category="Grand Exchange items"` |
63
+ | **Pages in custom namespace** | `get-site-info` → `get-category-members` | See DPL workflow below |
64
+ | **Backlinks to page** | `get-links-here` | `type="wikilinks"` / `transclusions` / `fileusage` |
65
+ | **Category members (as page list)** | `get-page "Category:Name"` | Returns wikitext list |
66
+
67
+ ## Dynamic Content Patterns
68
+
69
+ ### DPL (`<dpl>` tags) — Presentation, Not Data
70
+
71
+ When `get-page` returns wikitext containing `<dpl>` tags, **the data does not exist in that page**. DPL (DynamicPageList) is a presentation-layer extension that queries categories/namespaces at render time. The API **does not execute DPL**.
72
+
73
+ | Instead of... | Do this |
74
+ |---------------|---------|
75
+ | Reading the DPL page | `get-category-members` with the category + namespace DPL uses |
76
+ | Parsing `<dpl>` params | Check the DPL tag for `category=`, `namespace=`, `notcategory=` |
77
+
78
+ **Example**: `Game updates` page uses `<dpl category="Updates" namespace="1198" order=descending>`.
79
+ - Don't read `Game updates` for the list
80
+ - Do: `get-category-members "Updates" namespaces=[1198]`
81
+
82
+ ### Template Transclusion
83
+
84
+ Main pages often just include templates (e.g., `{{RecentUpdates}}`, `{{Updates}}`). The content lives in the **template page**, not the main page.
85
+
86
+ | Pattern | Action |
87
+ |---------|--------|
88
+ | `{{TemplateName}}` in page source | `get-page "Template:TemplateName"` |
89
+ | `{{#invoke:ModuleName|function}}` | `get-page "Module:ModuleName"` |
90
+
91
+ ### Namespaces as Content Types
92
+
93
+ Custom namespaces often map 1:1 to content types.
94
+
95
+ | OSRS Namespace | Content Type | Query Via |
96
+ |----------------|--------------|-----------|
97
+ | `Update:` (1198) | Game updates | `get-category-members "Updates" namespaces=[1198]` |
98
+ | `Calculator:` | Calculators | `get-category-members "Calculators" namespaces=[1200]` |
99
+ | `Module:` | Lua modules | `get-page "Module:Name"` |
100
+
101
+ ### Categories as Canonical Indexes
102
+
103
+ **The category often IS the list; the page is just a view.**
104
+
105
+ - `Category:Updates` + namespace 1198 = all game updates
106
+ - `Category:Bosses` = all boss pages
107
+ - `Category:Grand Exchange items` = all GE-tracked items
108
+
109
+ ## Discovery Workflow for DPL/Template Pages
110
+
111
+ ```
112
+ 1. get-page "Page Name" → see <dpl> or {{Template}} in source
113
+ 2. get-site-info → find relevant namespace ID(s)
114
+ 3. get-category-members → with that namespace + category
115
+ 4. get-pages → for individual item details
116
+ ```
117
+
118
+ This applies to any wiki using DPL/Category-based lists, not just OSRS updates.
119
+
120
+ ## Example: Get All 2026 Game Updates
121
+
122
+ ```bash
123
+ # 1. Check namespace for game updates
124
+ get-site-info
125
+
126
+ # 2. Get all updates (Update: namespace 1198, category "Updates")
127
+ get-category-members "Updates" namespaces=[1198]
128
+
129
+ # 3. Filter for 2026 client-side, or fetch individual pages
130
+ # Results include page titles like "Game update 2026-01-01"
131
+ ```
132
+
133
+ ## Example: Find All Calculators
134
+
135
+ ```bash
136
+ # Calculator namespace is 1200
137
+ get-category-members "Calculators" namespaces=[1200]
138
+ ```
139
+
140
+ ## get-links-here Usage
141
+
142
+ | Type | Use Case |
143
+ |------|----------|
144
+ | `wikilinks` (default) | Pages that link to target |
145
+ | `transclusions` | Pages that embed target (templates) |
146
+ | `fileusage` | Pages that display target (files) |
147
+
148
+ ```bash
149
+ # Pages linking to "Abyssal whip"
150
+ get-links-here "Abyssal whip" type="wikilinks"
151
+
152
+ # Pages using Template:Infobox item
153
+ get-links-here "Template:Infobox item" type="transclusions"
154
+ ```